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ABSTRACT 


The  objective  of  this  thesis  was  to  examine  the  feasibility  of 
implementation  and  the  performance  of  a  Software  Defined  Radio  datalink,  using 
a  common  PC  type  host  computer  and  a  high  level  programming  language. 
Dedicated  transceivers  were  used,  plugged  on  the  PCI  bus  of  host  PCs  running 
Windows  2000.  Most  of  the  functionality  was  programmed  using  the  Microsoft 
Visual  C++  language.  The  tasks  to  be  performed  included  the  channels 
configuration  (number  of  active  channels,  center  frequencies,  sampling  and  data 
rates,  choice  of  the  appropriate  up  and  down  conversion  filters),  the  management 
of  the  data  transfer  between  the  host  computer  and  the  transceiver,  the 
baseband  data  modulation  and  demodulation,  and  the  data  organization  into 
packets  with  appropriate  headers  in  order  to  achieve  phase  and  time 
synchronization  solely  by  software.  A  part  of  the  transceivers’  configuration  was 
achieved  using  a  configuration  utility  running  in  Excel,  provided  by  the 
manufacturer.  Several  combinations  of  M-PSK  modulation  schemes,  channel 
numbers  and  datarates  were  tested  in  order  to  measure  the  performance  limits  of 
the  system  and  its  ability  to  perform  the  required  tasks  in  real-time.  The  received 
data  streams  were  further  analyzed  with  the  use  of  Matlab,  in  order  to  verify  the 
proper  functionality  of  the  communication  scheme. 
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I:  INTRODUCTION 


A.  THE  NEED  FOR  SOFTWARE  DEFINED  RADIO 

Since  early  1980  an  exponential  increase  of  cellular  mobile  systems  has 
been  observed,  which  has  produced,  all  over  the  world,  the  definition  of  a 
plethora  of  analog  and  digital  standards.  In  the  current  years  the  industrial 
competition  between  Asia,  Europe,  and  America  promises  a  very  difficult  path 
towards  the  definition  of  a  unique  standard  for  future  mobile  systems,  although 
market  analyses  underline  the  trading  benefits  of  a  common  worldwide  standard. 

Existing  technologies  for  voice,  video,  and  data  use  different  packet 
structures,  data  types,  and  signal  processing  techniques.  Integrated  services 
can  be  obtained  with  either  a  single  device  capable  of  delivering  various  services 
or  with  a  radio  that  can  communicate  with  devices  providing  complementary 
services.  The  supporting  technologies  and  networks  that  the  radio  might  have  to 
use  can  vary  with  the  physical  location  of  the  user.  To  successfully  communicate 
with  different  systems,  the  radio  has  to  communicate  and  decode  the  signals  of 
devices  using  different  air-interfaces.  Furthermore,  to  manage  changes  in 
networking  protocols,  services,  and  environments,  mobile  devices  supporting 
reconfigurable  hardware  also  need  to  seamlessly  support  multiple  protocols, 
such  as  IP  (Internet  Protocol)  and  MExE  (Mobile  Execution  Environment).  Such 
radios  can  be  implemented  efficiently  using  software  radio  architectures  in  which 
the  radio  reconfigures  itself  based  on  the  system  it  will  be  interfacing  with,  and 
the  functionalities  it  will  be  supporting. 

Most  radio  receivers  and  transmitters  today  are  similar  to  those  used 

decades  ago.  They  consist  of  dedicated  analog  circuits  for  filtering,  tuning  and 

demodulating/modulating  a  specific  type  of  waveform.  To  make  radio  systems 

more  flexible,  a  software-defined  radio  is  currently  being  developed  for  both 

communication  and  broadcast  applications.  A  software  -  defined  radio  is  a  device 
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which  accommodates  a  variety  of  receiver/transmitter  programs  all  on  a  single 
hardware  platform.  The  programs  on  the  receiver  side  perform  band  pass 
filtering,  automatic  gain  control,  frequency  translation,  low-pass  filtering,  and 
demodulation  of  the  desired  signal,  and  similarly  on  a  transmitter  side. 
Maximizing  the  number  of  functions  handled  digitally,  allows  the  radio  to  take 
advantage  of  the  flexibility  of  the  digital  signal  processing  circuit. 


B.  DEFINITION  -  CHARACTERISTICS  OF  THE  SOFTWARE  DEFINED 

RADIO 

The  term  Software  Defined  Radio  (SDR)  was  coined  by  Joe  Mitola  in 
1991  (Ref.  4)  to  refer  to  the  class  of  reprogrammable  or  reconfigurable  radios.  In 
other  words,  the  same  piece  of  hardware  can  perform  different  functions  at 
different  times.  The  SDR  Forum  defines  the  ultimate  software  radio  (USR)  as  a 
radio  that  accepts  fully  programmable  traffic  and  control  information  and  supports 
a  broad  range  of  frequencies,  air-interfaces,  and  applications  software.  The  user 
can  switch  from  one  air-interface  format  to  another  in  milliseconds,  use  the 
Global  Positioning  System  (GPS)  for  location,  store  money  using  smart  card 
technology,  or  watch  a  local  broadcast  station  or  receive  a  satellite  transmission. 
Although  the  exact  definition  of  software  radio  is  a  bit  controversial,  however,  a 
good  working  definition  is:  a  radio  that  is  substantially  defined  in  software  and 
whose  physical  layer  behavior  can  be  significantly  altered  through  changes  to  its 
software. 

A  typical  software  defined  radio  architecture  is  shown  in  Figure  1-1. 
Although  a  thorough  description  of  the  several  modules  of  the  platform  will  be 
given  later  on,  for  the  time  being  let  us  emphasize  the  fact  of  the  early  signal 
digitization  just  after  the  RF  frontend  and  its  subsequent  treatment  in  the  discrete 
domain. 
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Figure  1-1.  A  typical  Software  Defined  Radio  model  (From  Ref.  4). 

Software  radios  are  emerging  in  commercial  and  military  infrastructure. 
This  growth  is  motivated  by  the  numerous  advantages  of  software  radios  such 
as: 


Ease  of  design  -  It  is  possible  to  design  many  different  radio  products 
using  a  common  RF  front-end  with  the  desired  frequency  and  bandwidth  in 
conjunction  with  different  signal  processing  software.  Thus,  it  frees  the  engineer 
from  much  of  the  iteration  associated  with  analog  hardware  design. 

Ease  of  manufacture  -  Given  the  same  input  in  two  digital  processors 
and  running  the  same  software,  they  will  produce  identical  outputs.  Thus,  the 
move  to  digital  hardware  reduces  the  costs  associated  with  manufacturing  and 
testing  the  radios. 

Multimode  operation  -  A  software  radio  can  change  modes  by  simply 
loading  appropriate  software  into  the  memory. 

Use  of  advanced  signal  processing  techniques  -  The  availability  of 
high  speed  signal  processing  on  board  the  radio  allows  implementation  of  new 
receiver  structures  and  signal  processing  techniques. 
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Fewer  discrete  components  -  A  single  high-speed  processor  may  be 
able  to  implement  many  traditional  radio  functions  reducing  the  number  of 
required  components  and  decreasing  the  size  and  cost  of  radio. 

Flexibility  to  incorporate  additional  functionality  -  Software  radios 
may  be  modified  in  the  field  to  correct  unforeseen  problems  or  upgrade  the  radio. 

The  factors  that  are  expected  to  push  a  much  wider  acceptance  of 
software  radio  are  the  following  five: 

Multifunctionality  -  Software  radio  reconfiguration  capability  can  support 
an  almost  infinite  variety  of  service  capabilities  in  a  system. 

Global  mobility  -  The  ability  of  the  software  radio  to  operate  with  all  the 
communication  standards  in  different  geographical  regions  of  the  world. 

Compactness  and  power  efficiency  -  The  software  radio  approach 
results  in  a  compact  and,  in  some  cases,  a  power-efficient  design  as  the  number 
of  systems  increases. 

Ease  of  manufacture  -  In  general,  digitization  of  the  signal  early  in  the 
receiver  chain  can  result  in  a  design  that  incorporates  significantly  fewer  parts, 
meaning  a  reduced  inventory  for  the  manufacturer. 

Ease  of  upgrades  -  As  new  devices  are  integrated  into  existing 
infrastructures,  software  radio  allows  the  new  devices  to  interface  seamlessly, 
from  the  air-interface  all  the  way  to  the  application,  with  the  legacy  network. 

Software  radios  derive  their  benefits  from  their  flexibility,  complete  and 
easy  reconfigurability,  and  scalability.  It  is  important  to  ensure  that  these 
characteristics  are  present  in  the  final  product.  A  generic  design  procedure  for 
software  radios  follows  and  demonstrates  the  interaction  between  the  various 
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subsystems  of  the  radio  design.  The  following  steps  focus  on  the  details  of  these 
design  procedures. 

Step  1:  Systems  engineering  -  Understanding  the  constraints  and 
requirements  of  the  communication  link  and  the  network  protocol  allows  the 
allocation  of  sufficient  resources  to  establish  the  service  given  the  system’s 
constraints  and  requirements.  In  an  ideal  software  radio  with  the  ability  to 
change  a  number  of  system  parameters  in  real-time,  optimizing  an  active 
communications  session  is  a  major  challenge. 

Step  2:  RF  chain  planning  -  The  ideal  RF  chain  for  the  software  radio 
should  incorporate  simultaneous  flexibility  in  selection  of  power  gain,  bandwidth, 
center  frequency,  sensitivity,  and  dynamic  range.  However,  achieving  strict 
flexibility  is  impractical  and  trade-offs  must  be  made. 

Step  3:  Analog*to-digital  and  digital-to-analog  conversion  selection 

-  Analog-to-digital  and  digital-to-analog  conversion  for  the  ideal  software  radio  is 
difficult  to  achieve  and,  in  practice,  the  selection  requires  trading  power 
consumption,  dynamic  range,  and  bandwidth  (sample  rate).  Analog-to-digital 
conversion  selection  and  vice  versa  is  closely  tied  to  the  RF  requirements  for 
dynamic  range  and  frequency  translation. 

Step  4:  Software  architecture  selection  -  The  software  architecture  is 
an  important  consideration  to  ensure  maintainability,  expandability,  compatibility, 
and  scalability  for  the  software  radio.  Ideally,  the  architecture  should  allow  for 
the  hardware  independence  through  the  appropriate  use  of  middleware,  which 
serves  as  an  interface  between  applications-oriented  software  and  the  hardware 
layer.  The  software  needs  to  be  aware  of  the  capabilities  of  the  hardware  (both 
DSP  and  RF  hardware)  at  both  ends  of  the  communications  link  to  ensure 
compatibility  and  to  make  maximum  use  of  the  hardware  resources. 
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step  5:  Digital  signal  processing  hardware  architecture  selection  - 

The  core  digital  signal  processing  hardware  can  be  implemented  through 
microprocessors,  FP-Gas,  and/or  ASICs.  The  selection  of  the  core  computing 
elements  depends  on  the  algorithms  and  their  computational  and  throughput 
requirements.  In  practice,  a  software  radio  will  use  all  three  core  computing 
elements,  yet  the  dividing  line  between  the  implementation  choices  for  a  specific 
function  depends  on  the  particular  application  being  supported. 

Step  6:  Radio  validation  -  This  step  is  perhaps  the  most  difficult.  It  is 
essential  to  ensure  not  only  that  the  communicating  units  operate  correctly,  but 
also  that  a  glitch  does  not  cause  system-level  failures.  Interference  caused  by  a 
software  radio  mobile  unit  to  adjacent  bands  is  an  example  of  how  a  software 
radio  could  cause  a  system-level  failure,  and  this  is  of  great  concern  to 
government  regulators.  Given  the  many  variable  parameters  for  the  software 
radio  and  the  desire  for  an  open  and  varied  source  of  software  modules,  it  is  very 
difficult  to  ensure  a  fail-proof  system. 

C.  ABOUT  THIS  THESIS 

The  objective  of  this  thesis  is  to  exploit  the  potential  (and  the  performance) 
of  implementing  a  software  defined  radio  using  standard  PC-type  computers. 
Lately,  the  advances  in  semiconductor  technology  have  boosted  the  performance 
of  computers,  increasing  the  processors  clock  rates  to  the  order  of  several  GHz, 
while  all  the  critical  links  needed  in  order  to  achieve  fast  and  reliable  data 
transfers  (memory,  hard  disks,  I/O  buses  etc)  are  now  much  more  optimized  and 
faster  than  some  years  ago.  Moreover,  the  internal  architecture  of  the  newest 
generation  of  processors  (like  Pentium  4  at  3.06  GHz)  make  them  ideal  for  multi 
threaded  applications,  which  is  a  key  fact  in  designing  multi-channel  applications 
for  the  SDR  platform. 
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The  above  facts  have  made  us  consider  quite  feasible  the  implementation 
of  a  SDR  datalink  using  dedicated  hardware  hosted  in  a  commercial  PC,  with  all 
its  functionality  programmed  in  a  high  level  programming  language.  In  order  to 
achieve  the  above  goal,  we  used  two  WaveRunner  253  SDR  transceivers, 
produced  by  Red-River  Inc,  Richardson  TX.  The  main  characteristics  of  the 
above  cards  are: 

•  Total  transmission/reception  bandwidth:  3-40  MHz. 

•  Up  to  8  fully  configurable  and  programmable  transmission/reception 
channels  of  up  to  3.5  Mbps  data  rate. 

•  Possibility  to  combine  individual  channels  in  polyphase  filters 
implementations 

•  Standard  PCI  form  factor,  supporting  32-  and  64-bit  PCI  buses 

All  the  programming  was  done  using  Microsoft  Visual  C++  V.7,  which  is  a 
part  of  the  Microsoft  Visual  Studio  NET  programming  suite.  The  channels  were 
configured  using  a  dedicated  configuration  tool,  provided  by  the  manufacturer. 

It  is  the  implementation  of  this  effort  that  this  thesis  will  try  to  depict.  In 
order  to  introduce  the  reader  to  the  theory  behind  the  implementation  and  make 
him  understand  the  steps  of  our  effort,  the  next  chapters  of  this  thesis  cover  the 
following  material: 

Chapter  II  covers  briefly  all  the  theory  required  to  understand  the 
functionality  of  a  SDR  transceiver.  The  subjects  that  are  covered  include  digital 
signal  synthesis,  multirate  digital  signal  processing,  analog-to-digital  and  digital- 
to-analog  conversion  features  and  software  requirements  and  specifications. 
Other  subjects  such  as  smart  antenna  design  for  SDR,  the  role  of  a  SDR  as  an 
integral  part  of  a  radio  network  and  the  systems  engineering  approach  to  the 
SDR  design,  are  far  beyond  the  scope  of  this  thesis  and  will  not  be  covered. 
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Chapter  III  presents  the  architecture  of  the  hardware  that  was  used.  The 
data  paths  of  the  transmitter  and  the  receiver  are  briefly  described.  More 
attention  is  given  to  the  Digital  Up  Conversion  (DUC)  and  the  Digital  Down 
Conversion  (DDC)  chips  which  are  the  “heart”  of  the  devices  and  their  operation 
ensures  the  correct  functionality  of  the  transceivers.  Also,  the  method  of  data 
exchange  between  the  host  computer  and  the  card  buffer  memory  is  explained. 
This  operation  is  quite  significant,  since  it  was  the  main  focus  of  our 
programming  efforts  described  in  the  next  chapter. 

Chapter  IV  is  divided  in  2  parts:  The  first  part  will  portray  the  configuration 
of  the  individual  channels,  using  the  dedicated  configuration  tool.  The  second 
part  explains  the  structure  of  our  program,  the  main  entities,  the  methods  of 
achieving  specific  results  on  the  cards  and  the  methods  of  interaction  between 
the  several  threads  of  the  application,  depending  on  the  number  of  active 
transmission  -  reception  channels.  The  programming  of  hardware  is  a  very 
elaborate  process,  with  hidden  dangers  in  every  step  of  it,  which  sometimes 
cannot  be  easily  identified.  Also,  a  thorough  knowledge  of  the  hardware 
functionality  is  required,  since  sometimes  the  most  unpredictable  things  can 
happen  by  setting  even  one  inappropriate  value  in  a  register. 

Chapter  V  outlines  the  results  of  our  effort.  Although  the  nature  of  this 
thesis  is  not  inherently  theoretical,  we  dare  say  that  according  to  our  knowledge  it 
is  the  first  time  that  a  radio  link  has  been  implemented  on  campus  using  standard 
commercial  “office”  computers  and  a  high  level  commercial  language.  So,  it  will 
be  quite  interesting  to  discover  the  potential  of  this  system. 

The  sixth  and  final  chapter  presents  the  conclusions  and  the  areas  for 
further  research.  The  potential  and  capabilities  of  the  hardware  we  used  are 
indeed  very  large.  Given  the  time  restrictions  of  this  thesis,  only  a  small  part  of 
these  capabilities  has  been  exploited.  We  just  proved  that  this  system  can  be 
built  and  that  it  has  an  acceptable  performance.  The  real  magic  of  this  platform 
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lies  on  the  flexible  and  adaptive  use  of  its  resources:  optimum  usage  of  the 
available  spectrum  and  automatic  reconfigurability  are  only  some  of  its  potentials. 

Last  but  not  least,  it  is  the  author’ s  opinion  that  the  control  of  hardware 
functionality  through  software  is  one  of  the  most  interesting  things  that  an 
electrical  engineer  can  do  today.  It  requires  a  lot  of  skills  and  knowledge  in  many 
different  areas  such  as  software  design,  communications  and  signal  processing. 
It  is  only  the  successful  “marriage”  of  these  skills  that  will  lead  to  successful 
results.  The  effort  of  the  last  months  and  the  pleasure  of  looking  at  the  results  of 
the  several  trials  have  given  the  author  the  kind  of  pleasure  that  only  those  who 
face  electrical  engineering  in  general  and  communications  more  specifically,  not 
only  as  a  profession,  but  also  as  a  hobby,  can  understand. 
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II:  THEORY  REVIEW 


A.  INTRODUCTION 

The  architecture  of  the  software  radio  receiver  is  quite  different  from  the 
classical  receiver  architectures,  with  the  heterodyne  receiver  being  the  most 
dominant  one. 

The  thorough  understanding  of  the  principles  of  operation  of  a  software 
radio  platform  requires  good  knowledge  of  several  technical  fields.  A 
representative  but  not  exhausting  list  of  these  fields  is: 

•  The  conversion  of  the  signal  from  the  analog  to  the  digital  domain  has 
moved  just  before  (for  the  transmitter),  or  just  after  (for  the  receiver) 
the  RF  frontend,  creating  new  requirements  for  faster  digital-to-analog 
or  analog-to-digital  converters,  operating  at  higher  frequencies  with 
acceptable  resolution. 

•  All  the  treatment  of  the  signal,  such  as  channelization  or  up  and  down 
conversion,  is  done  in  the  digital  domain  using  the  principles  of 
multirate  signal  processing.  However,  some  or  all  of  the  filters  used 
must  also  satisfy  requirements  from  the  communications  field  (such  as 
the  Nyquist  property). 

•  The  signals  required  to  feed  digital  mixers  in  order  to  generate  useful 
waveforms  are  generated  entirely  in  the  digital  domain  as  well.  There 
are  several  methods  to  do  that,  each  with  its  advantages  and 
disadvantages. 

•  Finally,  the  software  that  is  used  to  program  the  functionality  of  the 
platform,  must  posses  certain  properties  in  terms  of  robustness, 
performance  and  ability  to  control  the  hardware. 
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The  purpose  of  this  chapter  is  not  to  analyze  exhaustively  but  rather  to 
highlight  the  above  aspects  and  provide  a  brief  description  of  the  underlying 
principles. 

B.  RADIO  RECEIVER  TOPOLOGIES 


The  Tuned  Radio  Frequency  (TRF)  receiver,  shown  in  Figure  2-1, 
consists  of  an  antenna  connected  to  an  RF  bandpass  filter  (BPF).  The  BPF 
selects  the  signal  and  the  low-noise  amplifier  (LNA)  with  the  automatic  gain 
control  (AGC)  raises  the  signal  level  for  compatibility  with  the  analog-to-digital 
converter  (ADC).  This  BPF  bandwidth  relative  to  the  carrier  frequency  can  be 
quite  narrow,  while  in  absolute  bandwidth,  it  may  be  quite  broad. 


Figure  2-1.  TRF  Digital  Signal  Processing  Receiver  (From  Ref.  4). 

The  primary  difficulty  in  creating  a  practical  TRF  receiver  is  the  limitation 

of  the  ADC,  which  must  handle  high-frequency  signals.  In  addition,  given  the 

bandwidth  and  roll-off  limitations  of  the  RF  filter,  the  sampling  rate  of  the  ADC 

must  be  very  high  to  avoid  significant  aliasing.  High  power  consumption  is 

inevitable  with  high  sampling  rate  conversion.  Achieving  this  sampling 

characteristic  is  difficult,  expensive,  and  power-intensive,  and  extreme  demands 

are  made  of  the  tunable  RF  filter  to  remove  interference  signals  that  consume  the 

dynamic  range  of  the  ADC.  Non-idealities  of  the  ADC,  such  as  jitter  and  finite 

aperture  size,  lead  to  distortion  of  the  signal.  The  AGC  must  adjust  its  gain  to 

accommodate  varying  signal  levels  to  utilize  the  full  range  of  the  ADC  without 
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overloading  it.  However,  the  especially  high  gain  required  for  a  single-stage  AGC 
in  this  application  may  be  difficult  to  control.  Nevertheless,  the  advantage  of  this 
approach  is  the  minimal  number  of  analog  parts  required. 

A  very  popular  topology  for  low-power  applications  is  the  single 
conversion  receiver  (also  known  as  homodyne,  direct  conversion,  or  zero  IF 
receiver).  This  receiver  architecture  is  shown  in  Figure  2-2.  After  signal  filtering, 
amplification  and  gain  control,  a  single  mixing  stage  converts  the  signal  to 
baseband  or  near  baseband  coherently  (Figure  2-2a)  or  incoherently  (Figure  2- 
2b). 


(b) 


Figure  2-2.  Single  Conversion  Homodyne  Receiver  for  (a)  coherent  and  (b)  non 
coherent  reception  (From  Ref.  4). 
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In  the  case  of  a  phase  or  frequency  modulated  signal,  I  and  Q 
downconversion  is  required  since  the  upper  and  lower  sidebands  of  these  signals 
contain  different  information  and  the  sidebands  would  overlap  for  a  real 
downconversion.  Mixers  tend  to  have  high  power  consumption  and,  since  only 
one  mixer  stage  (possibly  I  and  Q)  is  used  in  the  single  conversion  receiver,  the 
receiver  potentially  offers  good  power  consumption  characteristics.  Typically, 
improved  power  consumption  at  the  mixer  can  be  traded  for  dynamic  range. 

In  some  cases,  rather  than  directly  downconverting  the  signal  to 
baseband,  it  may  be  more  convenient  to  downconvert  to  some  low  intermediate 
frequency  at  which  the  signal  may  be  digitized  and  downconverted  by 
subsequent  digital  signal  processing  operations.  A  more  complex  LPF  with 
better  roll-off  characteristics  can  help  reduce  out-of-band  interference  and  thus 
lessen  the  dynamic  range  requirement  of  the  ADC,  but  it  could  also  allow  more 
noise  to  enter  the  system  (less  sensitivity),  resulting  in  non-linear  distortion 
products  from  the  filter. 

The  most  common  RF  front-end  for  radios  is  the  heterodyne  receiver. 
This  receiver,  shown  in  Figure  2-3,  is  commonly  used  in  analog  radios.  A 
heterodyne  receiver  works  by  frequency  translating  the  incoming  signal  to  an  IF 
that  is  fixed  and  independent  of  the  desired  signal’s  center  frequency.  When  this 
IF  frequency  is  lower  than  the  center  frequency  of  the  received  signal’s  carrier 
frequency  and  higher  than  the  bandwidth  of  the  desired  signal,  the  receiver  is 
called  a  superheterodyne  receiver.  The  desired  signal  is  now  frequency- 
translated  to  a  fixed  IF  can  be  more  easily  filtered,  amplified,  and  demodulated. 
Plenty  of  good  quality  RF  components  are  available  for  standard  IF  frequencies. 
Often  a  superheterodyne  receiver  involves  using  two  stages  of  downconversion. 
Such  a  dual-conversion  receiver  has  the  advantage  of  relaxed  filtering 
requirements.  Because  the  filtering  occurs  in  stages,  the  filtering  requirements  at 
each  stage  can  be  more  relaxed  than  in  a  single-conversion  receiver.  That  is,  by 
lowering  the  center  frequency  of  the  signal  using  the  first  stage  of 
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downconversion,  the  filter  quality  factor  can  also  be  relaxed  because  the  ratio  of 
center  frequency  to  filter  bandwidth  is  reduced. 


(a) 


(b) 

Figure  2-3.  (a)  Heterodyne  Receiver,  (b)  Dual  conversion  Superheterodyne 

Receiver.  (From  Ref.  4). 

At  each  mixer  stage,  not  only  is  the  signal  downconverted,  but  also  a 
portion  of  the  band  at  coi,  the  image  frequency,  is  upconverted,  which  places  it  on 
top  of  the  frequency  translated  desired  signal.  This  problem  is  illustrated  in 
Figure  2-4.  For  instance,  a  68-MHz  LO  {ojlo)  will  downconvert  the  desired  signal 
by  68  MHz  ,  but  the  adjacent  band,  located  136  MHz  below  the  desire  signal,  will 
be  upconverted  to  the  same  frequency  range  (coif,  the  intermediate  frequency)  in 
which  the  desired  signal  now  lies.  To  mitigate  this  self-induced  interference,  an 
image  filter  precedes  the  mixer  to  suppress  the  low-frequency  band  that  might 
interfere  with  the  desired  signal  after  the  mixing  operation.  Designing  the  image 
filter  becomes  especially  challenging  if  the  band  of  potential  interference  is 
heavily  occupied  with  high-power  signals.  In  general,  trade-offs  exist  in  the 
selection  of  the  IF  frequency,  the  image  filter,  and  the  post-mixer  filter. 


15 


Figure  2-4.  The  heterodyne  receivers  image  frequency  problem  (From  Ref.  4). 


The  TRF  receiver  is  better  suited  for  a  software  radio  that  supports 
multiple  air-interface  modes  and  multiple  bands  than  the  single  conversion 
receiver  and  particularly  better  than  the  heterodyne  receiver  because  the  filter 
requirements  for  the  IF  stages  make  it  difficult  to  support  the  multiple  bandwidths 
that  might  be  required  of  a  multimode  receiver.  Retuning  a  receiver  can  result  in 
a  complex  interaction  of  multiple  components  comprising  the  RF  chain.  The 
simpler  the  RF  chain,  the  more  predictable  its  response  will  be  after  retuning. 
The  choice  of  a  single  or  double  conversion  receiver  depends  on  a  number  of 
factors  including  channel  spacing,  frequency  plan,  spurious  response,  and  total 
gain.  In  general,  the  smaller  the  channel  spacing,  the  more  attractive  the  double 
conversion  receiver  becomes  because  of  its  ability  to  narrowly  filter  the  desired 
signal. 
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c. 


MULTIRATE  SIGNAL  PROCESSING 


The  conversion  of  a  data  stream’s  sample  rate  is  an  important  part 
of  digital  signal  processing.  A  data  stream  can  be  downsampled  to  a  lower 
sampling  rate  or  upsampled  to  a  higher  sampling  rate,  with  the  processes  known 
as  decimation  and  interpolation.  Often,  a  non-integer  data  rate  conversion  is 
required  and  this  conversion  must  be  performed  in  one  or  multiple  stages.  These 
processes  are  the  subject  of  the  following  paragraphs. 

1.  Decimation 


Decimation  is  the  process  by  which  high-frequency  information  is 
eliminated  from  a  signal  to  reduce  the  sampling  frequency  without  resulting  in 
aliasing.  A  sampled  signal  repeats  its  spectrum  every  2tt  radians/sec.  If 
decimation  without  filtering  were  performed,  aliasing  would  occur  (Figure  2-5). 


Figure  2-5.  Aliased  spectrum  of  an  improperly  decimated  signal.  (From  Ref.  4). 


A  block  diagram  of  the  decimation  process  is  shown  in  Figure  2-6,  where 
the  operation  is  composed  of  lowpass  filtering  followed  by  downsampling.  The 
downsampler  picks  a  subset  of  the  samples  that  are  passed  through  the  lowpass 
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filter  (LPF).  The  LPF  used  is  designed  to  avoid  aliasing  and  has  a  cutoff  of  tt/D  , 
the  point  that  allows  the  non-aliased  part  of  the  signal  to  pass.  The  end  result  of 
the  decimation  procedure  is  the  content  of  the  original  signal  below  n/D ,  but  it  is 
sampled  at  a  lower  rate.  Figure  2-7  shows  the  expected  spectrum  of  the 
decimated  signal. 


F,  =  — 


-  h{n} 

v(n) 

Downsampler 

in 

y{m) 


FJi 

^  ~  D 


Figure  2-6.  Signal  decimation  by  a  factor  of  D.  (From  Ref.  4). 


The  frequency  domain  representation  of  the  decimated  signal  is  given  by 
the  following  equation: 


yM=^x 


D  ) 


\a)J  <  TT 


(2.1) 


Decimation  filters  out  the  information  in  the  original  signal  above  n/D 
(with  respect  to  the  original  sample  rate).  A  lowpass  direct  mapping  is  possible 
from  cUy  to  oj^  and  vice  versa;  this  relationship  is  best  described  as  the  spectrum 


spanned  by  X(6(j^),0  n/D ,  is  also  spanned  by  Y[a)y),  0<ajy<n . 
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2. 


Zero-Insertion  Interpolation 


Upsampling  is  the  process  to  increase  the  number  of  points  per  unit  time 
used  to  describe  a  signal.  When  upsampling  is  employed,  no  new  information  is 
added  to  the  signal.  The  process  of  upsampling  decreases  the  time  between 
samples  of  a  signal.  This  process  can  be  used  for  matching  sampling  rates 
between  two  systems  or  as  the  last  step  before  the  digital-to-analog  converter 
(DAC)  to  help  relax  the  requirements  for  the  reconstruction  filter. 


In  zero  -  insertion  interpolation,  zeros  are  inserted  between  samples  of  a 
signal,  generating  a  new  one.  This  new  one,  is  then  lowpass  filtered,  yielding  an 
upsampled  version  of  the  original  (Figure  2-8). 


Zero-Insertion 

(1=5) 


x(n)  ^ 

r 

Insert  1-1  Zeros 

v(m)  ^ 

h,(m) 

- : - ^ 

FIRLPF 

y(m) 


Figure  2-8.  Signal  interpolation  by  a  factor  of  5.  (From  Ref.  4). 


The  equation  that  describes  the  above  procedure  is  the  following: 

V,>=7^K')-  (2-2) 

Note  that  the  1//  factor  is  included  to  model  the  reduction  in  power  (in  the 
normalized  scale)  resulting  from  inserting  /-1  zeros.  The  above  equation  shows 
a  contraction  of  the  spectrum;  a  copy  of  the  spectrum  of  the  original  signal  is 
generated  every  2tt/I  radians/sec  instead  of  every  2tt  . 
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3. 


Zero-Insertion  and  Raised-Cosine 


To  minimize  inter-symbol  interference  (ISI),  pulse  shaping  is  important.  In 
order  to  achieve  this,  a  Nyquist  filter,  such  as  a  raised-cosine  pulse  shaping  filter, 
can  be  used.  For  example,  if  the  upsampling  of  a  pulse  code  modulation  (PCM) 
signal  is  to  be  performed  at  the  transmitter,  the  upsampling  and  raised-cosine 
filtering  can  be  combined  to  simplify  the  overall  design. 


This  implementation  is  performed  by  using  the  zero-insertion  interpolation 
method  described  earlier  but  with  a  raised-cosine  filter  combined  with  the 
lowpass  interpolation  filter  as  shown  in  Figure  2-9. 


Can  Be  Combined 

Pulses  of  Data 


Raised 

Cosine 

Pulses 


Upsampling  to  Increase 
Sample  Rate  of  Pulses 


Figure  2-9.  Combined  upsampling  and  Raised-Cosine  filtering.  (From  Ref.  4). 


4.  Non-Integer-Rate  Conversion 


Non-integer-rate  conversions  are  achievable  through  the  use  of  cascaded 
interpolations/decimations  such  that  a  total  rate  change  of  I/D  is  achieved. 


Figure  2-10  shows  a  block  diagram  of  the  implementation  of  a  non- 
integer-rate  conversion.  After  interpolation  by  a  factor  of  /,  the  signal  is  filtered  by 
a  LPF  having  a  cutoff  frequency  of  n/D  and  subsequently  it  is  decimated  by  a 
factor  of  D.  So,  the  overall  rate  conversion  is  I/D. 
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Figure  2-10.  Non-integer  datarate  conversion  (From  Ref.  3). 


The  following  equation  describes  the  above  procedure  mathematically; 


f  1 

r  1  ^ 

1  11.- 

^ TT  TT^ 

\  —  X 

— 

>  wJ<min 

-  - 

[D 

ID  ^ 

J  ' 

(I’D) 

(2.3) 


5.  Sampling  Rate  Conversion  by  Stages 

The  decimator  and  interpolator  discussed  so  far  are  of  a  single-stage 
structure.  When  large  changes  in  sampling  rate  are  required,  multiple  stages  of 
sample  rate  conversion  are  found  to  be  more  computationally  efficient.  Most 
practical  systems  employ  a  multi-stage  structure,  resulting  in  a  considerable 
relaxation  in  the  specifications  of  anti-aliasing  (decimation)  or  anti-imaging 
(interpolation)  filters  in  each  stage  compared  to  a  single  stage  realization. 

The  decimation  in  Figure  2-11  can  be  realized  in  three  stages  if  the  decimation 
factor  D  can  be  expressed  as  a  product  of  three  integers:  D^,  and  D^. 

Referring  to  Figure  2-11,  in  the  first  stage,  the  signal  x{n)  is  decimated  by  a 
factor  of  D.|  =  15 .  The  output  is  further  decimated  by  D2  =  3  in  the  second  stage 
and  the  output  of  the  second  stage  is  decimated  by  a  factor  D^=2  in  the  third 
stage,  resulting  in  an  overall  decimation  of  x{n)  by  D  =  {DP2D^)  = 
15x3x2  =  90.  The  filters  H^{z)  and  H^iz)  are  so  designed  that  the  aliasing  in 
the  band  of  interest  is  below  a  prescribed  level  and  that  the  overall  passband  and 
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stopband  tolerances  are  met.  The  filter  of  the  final  stage  (z)  may  be  quite 

sharp,  but  its  sampling  rate  is  much  lower  than  the  original  one,  reducing 
significantly  the  overall  computational  burden.  This  multi-stage  sampling  rate 
conversion  system  requires  less  computation  and  offers  more  flexibility  in  filter 
design. 


'S3 


Figure  2-11.  Decimation  realized  in  3  stages  (From  Ref.  3). 


6.  Cascaded  Integrator  Comb  Filters 

In  software  radio  systems,  sample  rate  changes  can  be  very  large,  with 
changes  from  many  tens  to  MFIz  to  around  100  kFIz  being  common.  Of  course, 
such  a  requirement  leads  to  large  order  and  high-rate  digital  filters,  which  can 
easily  become  a  bottleneck  in  the  overall  system  design.  A  cascaded  integrator 
comb  (CIC)  filter  can  be  used  to  reduce  the  computational  demands.  A  CIC  filter 
is  what  the  name  indicates:  a  cascade  of  simple  integrators  (accumulators)  and  a 
cascade  of  comb  filters  (delay  and  subtract  from  current  sample).  The  CIC  filter 
can  implement  an  interpolation  or  decimation  filter  that  uses  only  delay  and  add 
operations  and  thus  is  well-suited  for  FPGA  and  ASIC  implementation. 
Furthermore,  the  same  basic  filter  structure  can  be  used  to  handle  variable 
sample  rate  conversion. 


The  CIC  implementation  of  a  decimation  filter  is  the  cascade  of  an  integrator 
stage,  a  decimation  procedure,  and  a  comb  stage  as  shown  in  Figure  2-12.  To 
analyze  the  CIC  filter’s  response,  combining  the  integrator  and  comb  stages  into 
a  single  transfer  function  is  important  to  reduce  the  complexity  of  the  analysis. 
Flowever,  to  reduce  the  computational  expense  of  the  operation,  the 
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implementation  of  the  filter  is  performed  in  two  separate  sections,  before  and 
after  the  decimation. 


Integrator  Stages 


Comb  Stages 


High 

Sample  Rate 
Input 


Stage!  Stage  W  Stage  W+1  Stage  2/V 


Figure  2-12.  A  CIC  decimation  filter  (From  Ref.  4). 


The  frequency  response  (with  respect  to  the  higher  input  sample  rate)  is: 


H{aj) 


sin 


coRM 


hN 


sin 


J 


(2.4) 


where: 


N  is  the  number  integrator  and  comb  stages, 
M  is  the  differential  delay  of  each  comb  stage, 
R  is  the  decimation  rate  and 
oj  is  the  higher  input  frequency. 


By  letting  aj'  =  aj/R,  the  frequency  response  with  respect  to  the 
decimated  sample  rate  is  found  to  be: 


sin 

C  ttMu)'/2^ 

1  2  J 

sin 

f  TTOj'^ 
(2Rj 

(2.5) 


As  an  example,  the  frequency  response  of  that  equation  is  plotted  in 
Figure  2-13  for  N  =  4,  M  =  ^,  R  =  7  for  a  cutoff  frequency  f^=y8.  The  input 
sample  rate  is  7  and  the  output  sample  rate  is  1 . 
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Note  that  above  a  normalized  frequency  of  1,  the  transfer  function  will  fold 
and  we  will  have  aliasing,  but  its  magnitude  will  be  less  than  50  dB  down  from  its 
maximum  value.  Moreover,  since  the  CIC  filter  will  most  probably  be  followed  by 
a  decimation  stage  with  a  FIR  filter  with  a  cutoff  frequency  of  n/D  (where  D  is 
the  decimation  rate),  the  aliasing  in  the  useful  portion  of  the  spectrum  will  be 
even  less. 


CIC  Filter  Frequency  Response 


Figure  2-13.  Frequency  response  of  a  CIC  filter. 


7.  Polyphase  Decimation  and  interpolation 

The  decimation  and  interpolation  procedures  can  be  also  implemented  by 
the  polyphase  filters  (Figures  2-14  and  2-15).  In  this  implementation,  the 
decimation  or  interpolation  procedure  is  decomposed  into  a  sum  of  D  (or  /) 
parallel  filtering  stages.  In  the  decimation  process  the  filters  Pk(m)  are  formed  by 
decimating  x(m+k)  by  a  factor  of  D.  In  the  interpolation  process,  each  of  the  / 
stages  contributes  a  sample  at  the  output. 
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Figure  2.15.  General  structure  of  a  polyphase  interpolator  (From  Ref.  4). 
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With  the  use  of  the  polyphase  filters,  the  filtering  occurs  always  at  the 
lowest  frequency,  thus  reducing  the  computation  burden  significantly. 

Polyphase  implementation  of  the  decimation  process  of  the  reception 
channels  constitutes  a  characteristic  of  the  hardware  we  are  going  to  use. 
However,  since  we  will  not  deal  with  it  extensively,  we  mention  it  here  just  for 
reference. 

D.  DIGITAL  GENERATION  OF  SIGNALS 

The  synthesis  of  waveforms,  especially  sinusoidal  signals,  is  an  important 
part  of  a  communication  system.  Sinusoidal  signals  are  typically  used  in  many  of 
the  processing  steps,  such  as  modulation,  pulse-shaping,  and  filtering. 

Analog  techniques  have  long  dominated  frequency  synthesis.  Analog 
frequency  techniques  are  based  on  bulky  analog  devices  such  as  quartz  crystals, 
inductors,  capacitors,  and  mechanical  resonators.  Digital  techniques  began  to 
gain  prominence  in  communication  systems  because  of  their  superior  accuracy 
and  immunity  to  noise  and  because  they  are  easy  to  manufacture  with  very  large 
scale  integration  (VLSI).  Direct  digital  synthesis  (DDS)  techniques  generate 
signals  directly  in  discrete  time.  Any  arbitrary  waveform  can  be  generated  for 
digital  communication  systems,  as  the  amplitude,  frequency,  and  phase  can  be 
varied  to  create  a  modulated  signal. 

Direct  digital  synthesizers  allow  the  implementation  of  digital  modulation 
techniques,  after  which  the  signals  can  be  converted  to  analog  signals  for 
transmission.  Amplitude  modulation  (AM)  can  be  created  by  multiplying  the 
sinusoidal  output  of  the  ROM  with  the  modulating  signal  before  passing  it  through 
the  DAC.  Phase  modulation  (PM)  is  created  by  changing  the  instantaneous 
phase  angle,  i.e.,  by  using  the  modulating  signal  to  alter  the  input  to  the  ROM 
(phase).  Frequency  modulation  (FM)  is  created  by  varying  the  instantaneous 
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frequency,  and  this  is  accomplished  by  using  the  modulating  signal  to  increment 
the  phase. 

1.  Comparison  of  Direct  Digitai  Synthesis  with  Anaiog  Signai 
Synthesis 

The  digital  nature  of  DDS  makes  it  possible  to  set  the  frequency  of  the 
output  wave-form  more  precisely  than  analog  techniques.  In  analog  systems,  the 
frequency  is  controlled  with  analog  components,  resulting  in  poor  stability  due  to 
drift  in  the  components,  poor  frequency  resolution  due  to  limitation  in  analog 
dials,  and  difficulty  with  digitally  controlled  tuning.  Furthermore,  analog  signal 
generators  stray  in  frequency  over  time.  Changes  in  temperature,  humidity,  and 
other  variables  can  affect  the  output  of  the  analog  oscillator.  The  instrument’s 
overall  accuracy  varies  with  time  and  from  one  unit  to  the  next.  Precise 
generation  of  signals  leads  to  the  feasibility  of  very  close  channel  spacing,  which 
is  very  significant  for  narrowband  modulation  formats.  Analog  systems  are 
generally  limited  to  less  demanding  applications  in  which  tight  frequency  control 
and  accuracy  are  not  crucial.  Fine  frequency  steps  are  achieved  easily  with  a 
DDS  because  relatively  small  increases  in  circuit  complexity  can  add  a  decade  of 
additional  resolution.  Most  of  today’s  DDS  designs  provide  step  sizes  finer  than  1 
FIz  and  many  can  achieve  1  mHz  or  smaller. 

A  summary  of  the  advantages  and  disadvantages  of  the  DDS  is  presented 
in  the  table  2-1. 

2.  Approaches  to  Direct  Digital  Synthesis 

There  are  two  basic  approaches  for  generating  signals  directly  from  digital 
hardware.  The  first  is  commonly  referred  to  as  the  ROM  Look  Up  Table 
approach,  which  can  also  be  used  to  generate  sinusoidal  signals.  The  sampled 
values  of  the  sine  waveform  are  stored  in  ROM  and  are  output  periodically 
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through  a  DAC  to  generate  the  output  waveform.  The  second  approach,  pulse 
output  DDS,  uses  a  phase  accumulator  to  obtain  a  series  of  periodic  pulses  (or  a 
rectangular  or  sawtooth  waveform)  from  which  other  waveforms  can  be  created. 


Property 

Advantages 

Disadvantages 

Precision 

•  Possible  to  set  frequency 
accurately 

•  Can  achieve  very  high 
resolutions  (<1mHz) 

Flexibility 

•  Very  easy  to  change  the 
parameters 

Ease  of 
Implementation 

•  VLSI  implementations  are 
inexpensive  and  readily 
available 

Switching 

Frequency 

•  Possible  to  have  very  high 
switching  speeds,  within  Ips 

•  Output  is  smooth  and  transient 
free  during  frequency  change 

•  Possible  to  have  continuous 
phase  during  frequency 
switching 

Size  of  the 
Equipment 

•  Can  be  implemented  at  a 
fraction  of  the  size  of  a  similar 
analog  synthesizer 

•  Techniques  for  reducing 
spurious  signals,  e.g.,  hybrid 
DDS-PLLs,  can  increase  the 
size  of  the  system 

Bandwidth 

•  Can  be  varied  by  changing  the 
clock  speed 

•  Bandwidth  can  be  increased  by 
using  a  DDS-driven  PLL 

•  Output  frequency  limited  by 
the  Nyquist  frequency  to  half 
the  DDS  clock  rate  (Fclk/2) 

•  In  practice,  limited  to  Fclk/4 

Spectral  Purity 

•  Possible  to  get  very  high  quality 
of  signals  when  the  size  of  the 
accumulator  is  an  integral 
multiple  of  the  step  size  and 
there  is  no  phase  truncation 

•  Lots  of  spurious  signals 
when  there  is  phase 
truncation  or  other  jitter 

•  Need  to  use  special 
techniques  to  reduce 
spurious  responses,  e.g., 

ROM  compression,  hybrid 
DDS-PLL,  or  randomization 

Table  2-1.  Comparison  of  Direct  Digital  Synthesis  with  Analog  Signal  Synthesis 


3.  Pulse  Output  Direct  Digital  Synthesis 

One  of  the  simplest  forms  of  a  DDS  system  is  a  pulse  output  DDS  (PO 
DDS)  system.  This  DDS  approach  generates  pulse,  sawtooth,  or  rectangular 
waveforms.  Other  waveforms  can  be  created  from  these  basic  waveforms.  The 
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idea  is  to  create  the  rectangular  waveform  by  cycling  through  an  accumulator  as 
a  way  to  create  an  adjustable  pulse  frequency  from  a  stable  high-frequency 
driving  clock.  PO  DDS  consists  of  an  N  bit  adder  and  register  to  form  an 
accumulator.  A  frequency  word  Ar,  is  added  to  the  accumulator  once  every  clock 
period,  7^,^ .  Figure  2-16  shows  a  PO  DDS. 


Figure  2-16.  Pulse  Output  Direct  Digital  Synthesis  (From  Ref.  4). 

The  output  of  the  accumulator,  S{n)  at  time  n,  is  given  by 

S(n)  =  (S(n-1)-i-Ajmod2'^  and  is  performed  in  modulo  2'^  arithmetic.  The 

accumulator  will  overflow,  and  the  counter  resets  on  average  once  every 
2'^  /  clock  periods.  The  average  frequency  for  which  the  counter  is  reset  is 

(2.6) 

The  output  of  this  synthesizer  could  be  the  carry  output  of  the  accumulator 
for  a  pulse  output  or  the  most  significant  bit  (MSB)  of  the  accumulator  to 
represent  the  approximate  square  wave  output,  or  S{n),  for  a  sawtooth 
waveform. 
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4. 


Rom  Look-Up  Table  Approach 


The  ROM  LUT  approach  uses  sampled  values  of  a  periodic  function 
stored  in  a  ROM.  Every  clock  cycle,  a  value  of  the  periodic  function  stored  in  the 
ROM  is  output  through  a  DAC  to  generate  the  synthesized  signal.  The  output 
from  the  DAC,  however,  is  a  distorted  analog  signal  due  to  the  sample  and  hold 
nature  of  the  waveform.  Therefore,  the  signal  obtained  at  the  output  of  the  DAC 
is  passed  through  LPFs  and  amplifiers  to  obtain  the  final  analog  waveform. 
Sometimes  it  is  advantageous  to  perform  digital  filtering  before  the  digital-to- 
analog  conversion  to  compensate  for  the  distortion  of  the  non-ideal  analog  filters. 

DDS-based  function  generators  are  based  on  a  single  crystal  oscillator, 
which  generates  a  reference  clock  frequency.  The  structure  of  a  DDS  system 
using  a  ROM  LUT  is  shown  in  Figure  2-17.  The  adder  and  register  function  as 
an  accumulator  and  increment  the  output  value  by  at  each  clock  cycle.  For 
example,  if  the  first  adder  output  is  zero  and  the  phase  increment  is  17,  then 
the  second  output  would  be  17,  the  third  would  be  34,  the  fourth  51,  etc. 


Clock 


Figure  2-17.  ROM  LUT  Direct  Digital  Synthesis  (From  Ref.  4). 


The  output  of  the  accumulator  takes  the  form  of  an  address  used  by  a 
ROM  LUT  that  contains  the  waveform  samples.  The  number  of  clock  cycles 
needed  to  step  through  the  entire  ROM  LUT  defines  the  time  period  of  the 
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waveform.  The  waveform  period  is  determined  by  .  The  LUT  holds  the  digital 

representation  of  the  desired  waveform,  which  is  made  up  of  digital  words  that 
define  the  amplitude  of  the  waveform  as  a  function  of  phase.  The  address 
generated  by  the  adder  represents  the  phase  value  of  the  waveform. 

The  address  generator  sequentially  reads  the  table  of  digital  values  out  of 
the  memory  and  passes  them  to  a  DAC  to  generate  the  output  waveform.  The 
DAC  changes  each  of  these  digital  words  into  an  analog  voltage,  which  is  fed 
through  filters  to  reduce  the  distortion  and  amplifiers  to  produce  an  analog  signal. 
The  period  of  the  output  waveform  is  based  on  the  phase  increment  value 
and  the  frequency  of  the  clock  signal  . 

5.  Performance  Assessment  of  the  DDS  Systems 

The  major  drawbacks  of  a  DDS  system  are  spectral  purity  and  sideband 
noise.  The  sources  of  spurious  signals  are  amplitude  and  phase  truncation  due 
to  the  limited  number  of  bits  used  for  their  representation,  as  well  as  DAC  non- 
linearities.  Several  methods  are  used  to  mitigate  these  problems,  such  as  the 
randomization  (Ref.  4).  A  block  diagram  of  the  Wheatley’s  procedure  is  shown  in 
Figure  2-18. 


Figure  2-18.  Wheatley’s  procedure  (From  Ref.  4). 
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The  method  consists  of  adding  a  sequence  of  random  numbers  to  the 
contents  of  the  accumulator  in  a  prescribed  manner,  in  order  to  convert  the 
discrete  harmonic  signals  into  a  continuous  noise  floor,  whose  level  is  much 
lower  than  that  of  the  harmonic  signal.  Figure  2-19  shows  the  spectrum  of  a 
DDS,  before  and  after  the  Whealtey  method  has  been  applied. 
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Figure  2-19.  DDS  spectrum  before 
method  (From  Ref.  4). 

E.  ANALOG-TO-DIGITAL  AND  DIGITAL-TO-ANALOG  CONVERSION 

The  digital-to-qnalog  converters  (DAC)  and  the  analog-to-digital 
converters  (ADC)  constitute  in  many  instances  the  determining  factor  for  the 
performance  of  the  software  radio,  since  they  impact  the  power  consumption, 
dynamic  range,  bandwidth  and  total  cost. 

Ideally,  the  data  conversion  should  take  place  immediately  after  the 
antenna  in  the  receiver  chain.  The  RF  signal  should  be  sampled  and  all  the 
downconversion  procedure  should  be  carried  out  entirely  in  the  digital  domain. 


Spectral  Characteristics  for  ^  z  d,  W^S,  na  =  32,  and  A,  =  7  (Wheatley's  Procedure) 
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However,  this  process  would  place  some  extreme  constrains  on  the  data 
converter.  It  would  need: 

•  Very  high  sampling  rate,  in  order  to  support  wide  signal  bandwidths 

•  A  large  number  of  quantization  bits,  in  order  to  support  a  high  dynamic 
range. 

•  A  large  operating  bandwidth  (in  the  order  of  hundreds  of  MHz  or  even 
some  GHz)  to  accommodate  a  greatly  varying  range  of  signal  frequencies. 

•  A  large  spurious-free  dynamic  range  to  allow  the  recovery  of  small-scale 
signals  in  the  presence  of  strong  interferers. 

•  Small  power  consumption,  while  simultaneously  meeting  all  the  above 
criteria. 

Unfortunately,  the  current  capabilities  of  the  available  technology  do  not 
make  it  possible  to  fabricate  converters  meeting  the  above  specifications.  So,  an 
RF  frontend  is  included  after  the  antenna,  at  which  the  signal  is  downconverted 
to  an  appropriate  IF  frequency  and  data  conversion  takes  place  at  that  frequency 


F.  CHOICE  OF  THE  APPROPRIATE  HARDWARE 

The  choice  of  the  hardware  composition  of  a  software  radio  is  a  key  step 
in  its  design.  This  choice  is  dictated  by  the  requirements  in  four  main  areas: 
flexibility,  modularity,  scalability  and  performance. 

There  are  three  main  categories  of  digital  hardware  available:  Digital 
Signal  Processors  (DSP),  Field  Programmable  Gate  Arrays  (FPGA)  and 
Application  Specific  Integrated  Circuits  (ASIC).  Each  of  them  exhibits  a  certain 
level  of  reprogrammability,  that  is,  an  ability  to  change  the  device  software. 
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1.  Digital  Signal  Processors  (DSP) 


A  DSP  is  designed  to  support  high-performance,  repetitive,  numerically, 
intensive  tasks  and  very  high  I/O  performance.  DSPs  are  designed  to  include 
special  functional  units  in  the  hardware  as  well  as  special  instructions  in  the 
microcode.  Some  DSPs  provide  for  several  accesses  to  memory  in  a  single 
cycle.  Program  flow  control  features  speed  up  the  execution  of  common  DSP 
tasks  like  FFT  or  Viterbi  decoding.  Large  accumulators  in  DSPs  help  reduce 
precison  problems.  Certain  DSPs  are  also  optimized  for  specific  applications  like 
wireline  communications,  wireless  communications,  or  general  control 
applications. 

2.  Field  Programmable  Gate  Arrays  (FPGA) 

The  FPGA  was  introduced  in  the  mid-1980s  as  a  device  to  process  digital 
logic.  FPGAs  were  designed  for  multilevel  circuits,  which  means  they  could 
handle  complex  circuits  on  a  single  chip.  Since  FPGAs  were  prefabricated,  they 
were  quicker  to  use  and  less  expensive.  The  volatility  of  SRAM  makes  the  FPGA 
attractive  for  digital  systems.  FPGAs  are  now  used  in  various  configurations,  as 
in  multimode  and  reconfigurable  systems,  and  are  very  useful  in  meeting  the 
needs  of  a  software  radio  system. 

Like  programmable  logic  devices  (PLDs),  FPGAs  are  also  completely 
prefabricated,  but  they  are  optimized  for  multilevel  circuits  rather  than  two-level 
logic  and  contain  special  features  for  customization.  These  properties  allow  them 
to  handle  much  more  complex  circuits  on  a  single  chip  but  often  sacrifice  the 
predictable  delays  of  a  PLD.  Several  kinds  of  FPGAs  exist,  such  as  SRAM  cells, 
erasable  programmable  read-only  memory  (EPROM),  electrically-erasable 
programmable  read-only  memory  (EEPROM),  or  anti-fuses. 
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3.  Implementing  DSP  Functions  in  FPGAs 


There  are  two  ways  of  implementing  DSP  functions  on  an  FPGA,  bit  serial 
and  bit  parallel  distributed  arithmetic.  Both  methods  are  scalable,  which  allows 
the  designer  to  optimize  the  design  for  performance  and  density.  Bit  serial 
distributed  arithmetic  is  an  implementation  technique  that  processes  parallel  data 
flow  structures  bit  sequentially,  thereby  allowing  multiple  functions  to  performed 
simultaneously.  For  example,  when  implementing  a  sixteen-tap  FIR  filter,  all 
sixteen  data  samples  are  multiplied  in  parallel  in  a  bit  serial  process.  Bit  parallel 
distributed  arithmetic  is  a  similar  technique  but  with  multiple  bits  being  processed 
in  parallel,  allowing  the  overall  performance  of  the  design  implementation  to 
scale  proportionately  to  required  resources.  At  high-performance  levels,  e.g., 
thirty  to  seventy  million  samples  per  second  (MBPS),  the  FPGAs  can  be 
partitioned  to  perform  all  operations  in  parallel,  minimizing  the  number  of  clock 
cycles  required  to  perform  a  function.  At  lower-performance  levels,  e.g.,  one  to 
ten  MBPS,  bit-sequential  operations  allow  more  efficient  resource  use. 

To  better  understand  the  performance  and  cost  benefits  using  FPGA 
devices,  consider  the  design  of  an  eight-bit,  sixteen-tap  FIR  filter.  Most 
programmable  DBPs  can  perform  a  memory  access  control  (MAC)  function  in 
one  clock  cycle.  Therefore,  implementing  the  FIR  filter  in  a  66-MHz  DBP  would 
yield  a  theoretical  maximum  saple  rate  of  66  MHz/16  taps  =  4.125  MBPB, 
excluding  memory  overhead  operations.  In  contrast  with  a  FPGA-based 
implementation,  the  designer  could  use  bit-serial  distributed  arithmetic  where  all 
sixteen  taps  are  processed  in  parallel.  Using  the  same  66-MHz  clock  rate,  this 
implementation  can  process  the  data  at  15  ns  per  bit;  for  eight-bit  data  this 
equates  to  8.33  MBPB,  twice  the  sample  rate  of  66-MHz  programmable  DBP 
device. 
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4.  Using  a  Combination  of  DSPs,  FPGAs,  and  ASICs 


When  system  performance  demands  exceed  existing  processor  capability, 
a  number  of  approaches  are  used  to  solve  the  problem,  including  custom 
integrated  circuits  (ASICs),  function  specific  DSP  cores,  multi-processor 
architectures  and  reconfigurable  architectures.  A  popular  trend  is  the  use  of 
DSPs  as  cores  inside  ASICs  to  provide  some  degree  of  flexibility  to  the  ASIC. 
Another  popular  method  of  boosting  the  performance  of  a  DSP  places  multiple 
DSPs  in  parallel  along  with  a  high-speed  memory.  FPGAs  can  also  be  used  to 
enhance  a  given  DSP.  The  parallel  paths  of  an  algorithm  can  be  implemented  on 
the  FPGA  while  the  DSP  handles  the  sequential  and  other  general  sections  of 
the  algorithm.  The  FPGA  can  be  programmed  to  perform  any  number  of  parallel 
paths.  These  operational  data  paths  can  consist  of  any  combination  of  simple 
and  complex  functions,  such  as  adders,  barrel  shifters,  counters  comparators, 
correlators  and  so  forth. 

G.  OBJECT  ORIENTED  PROGRAMMING  (OOP)  AND  THE  SDR 

The  main  principle  of  the  OOP  is  the  existence  of  objects.  Objects  are 
autonomous  entities  with  their  own  functionality  and  data,  which  constitute 
distinct  instantiations  of  classes.  Classes  are  prototype  entities  which  define  what 
the  functionality  and  data  will  be.  Objects  and  classes  have  useful  properties 
such  as: 

•  Inheritance;  a  derived  -  or  child  -  class  can  inherit  all  the  attributes 
and  functionality  of  the  parent  class  and  add  its  own  functionality. 

•  Polymorphism:  the  functionality  of  the  parent  class  can  be  modified, 
or  take  alternate  forms,  in  order  to  serve  the  specific  needs  of  the 
derived  class. 

•  Encapsulation:  The  access  to  the  functionality  and  data  of  the  class 
can  be  controlled  by  the  class  creator.  In  this  way,  enough  information 
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can  be  accessible  by  the  outside  programmer  in  order  to  take 
advantage  of  the  class  functionality,  but  not  adequate  enough  to 
disturb  the  normal  behavior  of  the  class. 

•  Overloading;  This  feature  allows  the  class  to  create  multiple 
behaviors  according  to  the  situation  and  thus  adapt  to  a  variety  of 
conditions. 

A  radio  platform  can  be  broken  up  into  discrete  objects,  each  of  which 
interacts  with  other  objects  in  the  system.  This  object  oriented  way  of  looking  at 
the  world  can  be  translated  into  software  and  the  several  programs  that  control 
the  functionality  of  the  platform  can  be  based  on  discrete  objects,  each  of  which 
interacts  with  other  objects  and  the  system  through  well  defined  interfaces. 

The  use  of  objects  will  allow  the  software  to  mimic,  at  least  in  form,  the 
layout  of  a  real  system.  The  object-oriented  approach,  through  the  use  of 
abstract  classes,  can  be  used  to  create  a  framework  from  which  development 
can  be  structured  and  system  integration  can  be  simplified. 

There  are  several  possible  candidate  languages  which  can  serve  as  the 
development  platforms  for  writing  the  software.  Each  one  has  advantages  and 
disadvantages.  In  the  following  two  paragraphs,  we  will  examine  two  of  them, 
C++  and  Java.  This  is  due  to  the  wide  acceptance  of  the  above  languages  from 
the  programming  community,  as  well  as  to  the  extensive  features  that  they  offer. 

1.  C++ 

So  far,  C++  seems  as  the  most  suitable  language  for  the  development  of 
the  SDR  applications.  This  is  due  to  several  reasons: 

•  It  is  an  inherently  object  oriented  programming  language. 


37 


•  Since  it  is  derived  from  the  classical  C  language,  it  has  been  in  use  for 
many  decades  and  is  widely  accepted. 

•  It  offers  the  possibility  for  detailed  access  and  control  into  the  lowest 
level  of  hardware,  thus  ensuring  fast  execution  and  good 
performance,  when  the  application  is  time  critical  (high  data  rates, 
etc). 

A  drawback  of  the  language  stems  from  its  inherent  advantages:  In  order 
to  ensure  the  fastest  possible  performance,  the  overhead  and  the  self  control  of 
the  code  is  minimal,  resulting  in  errors,  many  of  which  appear  at  run  time  and  are 
quite  difficult  to  debug.  Moreover,  the  freedom  that  it  gives  to  the  programmer, 
has  as  a  counterbalance  a  relatively  complex  syntax  and  complicated  rules  and 
dependencies  between  the  objects  of  the  application,  which  sometimes  require 
extensive  experience  from  the  software  developer  in  order  to  build  large 
comprehensive  and  easily  maintainable  applications. 

2.  Java 

Java  was  created  out  of  an  effort  of  the  software  community  to  overcome 
the  inherent  difficulties  of  the  C++.  Although  it  is  a  fully  object  oriented  language 
(actually  more  object  oriented  than  C++;  nothing  can  exist  outside  a  class,  unlike 
C++  where  global  variables  and  functions  are  allowed),  it  has  several  unique 
features  such  as: 

•  Simplified  dependency  rules  between  the  different  entities  of  the 
application,  which  result  to  much  easier  software  development  and 
maintenance. 

•  More  overhead  and  checking  rules,  which  avoid  common  problems  of 
the  C++  language,  such  as  bounds  checking,  memory  overflows  and 
proper  objects  use. 


38 


•  Platform  interoperability.  The  Java  applications  are  not  written  with  a 
specific  platform  in  mind.  The  output  of  the  code  compilation  is  a 
binary  code  which  communicates  with  the  specific  hardware  on  which 
it  is  supposed  to  run,  via  Hardware  Abstract  Layers.  The  Java 
program  is  actually  interpreted  during  runtime. 

The  main  disadvantages  of  the  language  stem  from  its  features.  The 
extensive  overhead,  procedures  such  as  the  garbage  collector,  which  run  at 
unpredicted  times  and  for  unpredicted  time  lengths,  as  well  as  the  slow  execution 
rates  due  to  the  runtime  interpretation  of  the  binary  code,  raise  serious  doubts 
about  the  ability  of  the  language  to  support  the  core  functions  of  the  platform, 
which  are  time-critical  and  require  a  minimum  acceptable  performance. 

However,  although  rather  inappropriate  for  the  physical  and  data  layers, 
Java  could  be  a  good  candidate  for  the  application  layer.  This  layer  will  need  to 
deal  with  constantly  changing  QoS  settings,  making  the  development  of  the 
applications  using  a  less  dynamic  language  such  as  C++  very  difficult. 
Furthermore,  since  Java  was  developed  with  the  Internet  in  mind,  it  is  designed 
to  allow  easy  adaptation  between  platforms  with  different  capabilities. 

H.  MULTITHREADED  PROGRAMMING 

A  typical  software  radio  application  will  most  probably  involve  multiple 
transmission  and  reception  channels  operating  simultaneously.  The  best  and 
most  reasonable  way  to  achieve  the  parallel  execution  of  the  routines  serving 
each  one  of  the  channels,  especially  in  a  multitasking  environment  such  as 
Windows  where  precise  timing  control  of  the  execution  of  the  code  is  impossible, 
is  to  use  multithreaded  programming. 

A  thread  as  the  word  implies,  is  an  autonomous  path  of  code  execution. 
Every  application  is  a  large  thread.  Within  this  master  thread,  multiple  other 
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threads  can  be  launched,  all  of  them  running  simultaneously  (technically 
speaking  they  run  in  turns,  consuming  a  bit  of  the  processor  time,  but  to  the  user 
they  seem  to  run  simultaneously)  and  -  most  important  -  sharing  the  same  data 
segment  with  the  launching  application. 

The  32  bit  versions  of  the  Windows  operating  system  support 
multithreaded  operation.  Moreover,  the  last  generation  of  the  Intel  Pentium  4 
processors  is  specially  designed  for  multithreaded  applications. 

The  problem  that  multithreaded  programming  has  to  solve  is  how  the 
several  threads  communicate  and  how  they  signal  events  to  one  another.  As  we 
shall  see  in  Chapter  4,  every  time  the  communication  gets  active,  a  master 
thread  is  launched,  which  in  turn  launches  one  thread  per  active  channel. 
However,  how  will  the  master  thread  know  when  the  channel  threads  are  done 
with  their  work,  in  order  to  proceed  further? 

The  above  problem  has  two  solutions: 

a)  Through  a  global  variable:  The  thread  that  wants  to  signal  the  change 
of  state,  modifies  the  value  of  a  global  variable.  The  monitoring  thread  constantly 
reads  the  value  of  the  variable  and  when  it  changes,  the  thread  takes  appropriate 
action.  Perfect  you  will  say.  Well,  not  exactly.  This  method  has  some  drawbacks, 
the  most  important  of  which  is  that  as  the  monitoring  thread  continuously 
monitors  the  value  of  the  global  variable,  it  consumes  unnecessary  processor 
cycles,  thus  slowing  the  execution  of  other  threads.  This  bottleneck  may  limit  the 
performance  of  the  application  in  the  case  of  high  data  rates.  So,  in  order  to 
overcome  the  problem,  inevitably  we  pass  to  the  second  solution  which  is  ... 

b)  Through  events.  A  window  event  is  a  flag  which  has  two  states:  set  and 

reset.  When  the  monitoring  procedure  has  to  wait  for  a  signal,  it  executes  the 

order  ::WaitForSingleEvent().  By  executing  this  command,  it  falls  in  an  idle  state, 

where  it  stays  in  a  suspended  mode  and  does  not  consume  any  processor  time. 

When  the  signaling  event  needs  to  signal  a  change  of  state,  it  sets  the 
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appropriate  event.  This  action  wakes  the  monitoring  thread,  which  continues  the 
execution  of  its  code. 


I.  FROM  HERE  ... 

This  chapter  has  outlined  several  of  the  technologies  used  in  the  design 
and  implementation  of  a  software  defined  radio  platform.  By  now  the  user  has 
acquired  a  pretty  good  idea,  although  not  detailed  admittedly,  about  the 
principles  of  operation  of  the  equipment  we  are  using  in  this  thesis. 

Now,  it  is  time  to  see  the  actual  equipment,  have  an  inside  look  at  its 
capabilities,  the  aforementioned  principles  that  it  incorporates  and  how  we  can 
take  advantage  of  them  in  order  to  control  the  hardware  for  our  purposes  of 
communication.  This  is  the  objective  of  the  next  chapter. 
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Ill:  DESCRIPTION  OF  THE  HARDWARE 


A.  INTRODUCTION 

In  the  previous  chapter  we  set  all  the  necessary  theoretical  background 
required  to  understand  the  principles  of  operation  of  a  software  radio  transceiver. 
Now  it  is  time  to  see  how  these  principles  are  applied  in  practice.  In  the  current 
chapter  we  will  describe  the  architecture  and  the  characteristics  of  the  hardware 
we  are  going  to  use.  We  will  follow  the  signal  flow  from  the  host  computer 
memory  to  the  transmitter  output  and  from  the  receiver  input  to  the  host 
computer  memory.  We  will  see  how  the  signal  is  processed  at  the  several 
stages  of  the  transceiver  and  how  we  can  intervene  and  program  the  desired 
output  of  this  processing. 

At  the  end  of  this  chapter,  the  reader  will  be  ready  to  proceed  to  the  next 
chapter,  which  is  actually  the  description  of  all  the  work  that  has  been  done 
during  this  thesis. 

B.  HARDWARE  CHARACTERISTICS 

The  hardware  used  for  this  thesis  is  the  WaveRunner  253  Plus  PCI  high 
performance  programmable  transceiver,  manufactured  by  Red  River,  Richardson 
TX.  Its  main  characteristics  are: 

•  Industry  Standard  PCI  Form  Factor 

•  40  MHz  Analog  I/O  Bandwidth  (0  to  40  MHz) 

•  8.6  MHz  Maximum  Signal  Bandwidth 

•  Up  to  8  Transmit  and  Receive  Channels 

•  Up  to  90  dB  Linear  Dynamic  Range 

•  PCI  Bus  Master  With  Auto  DMA  Feature 
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•  32/64-bit  and  33/66  MHz  PCI  Support 

•  Windows  /  Linux  Drivers 


A  picture  of  the  transceiver  is  shown  in  Figure  3-1.  A  detailed  block 
diagram  of  the  device  is  shown  in  Figure  3-2. 


Figure  3-1 .  WaveRunner  253  PCI  programmable  SDR  transceiver  (From  Ref.  7). 


Receiver  Data  Buffer 


Transrritter  Data  Buffer 


Figure  3-2.  WaveRunner  253  Plus  detailed  block  diagram  (From  Ref.  7). 
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The  device  consists  primarily  of  3  sections: 

•  The  transmitter  section 

•  The  receiver  section 

•  The  memory  controller  section 

The  function  of  each  one  of  the  above  sections  will  be  described 
analytically  in  the  following  sections. 


C.  TRANSMITTER  DATAPATH 

The  transmitter  is  comprised  of  four  elements: 

•  The  Transmitter  Data  Buffer 

•  Two  Dual  Quad  Programmable  Digital  Upconverters  (QPUC) 

•  One  D/A  Converter 

•  The  Transmitter  Front-End 


A  diagram  of  the  transmitter  datapath  is  shown  in  Figure  3-3.  Detailed 
description  of  the  above  elements  follows. 


Transmitter  Data  Buffer 


PCI  Interface 

4'  ► 


TX  Out 
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Figure  3-3.  WaveRunner  253  Plus  Transmitter  datapath  (From  Ref.  7). 
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1. 


Transmitter  Data  Buffer 


The  transmitter  has  a  dedicated  256-kbyte  buffer  capable  of  storing  64 
ksamples  of  complex  data  (16-bit  I,  16-bit  Q).  The  buffer  acts  as  a  first-in,  first-out 
(FIFO)  to  perform  data  rate  translation  between  the  PCI  bus  and  the  QPUC 
inputs.  The  buffer  operates  as  a  multi-queue  FIFO  that  can  be  organized  into  a 
variety  of  configurations  from  a  single  large  queue  occupying  all  256  kbytes  to 
eight  smaller  queues  of  varying  size.  This  flexibility  provides  the  user  ultimate 
control  over  data  flow  and  can  be  used  to  tailor  the  memory  to  different  channel 
rates  and  bandwidths. 

2.  Dual  Quad  Programmable  Upconverter  (QPUC) 

Two  Intersil  ISL5217  QPUC  chips  are  used  to  convert  digital  baseband 
data  into  modulated  or  frequency  translated  digital  samples.  The  QPUC  can  be 
configured  to  create  any  quadrature  amplitude  shift-keyed  (QASK)  data 
modulated  signal,  including  QPSK,  BPSK,  and  M-ary  QAM.  The  QPUC  can  also 
be  configured  to  create  both  shaped  and  unfiltered  FM  signals.  The  QPUC 
performs  the  compute  intensive  tasks  of  tuning,  filtering,  resampling,  interpolation 
and  gain  control. 

As  shown  in  Figure  3-4,  two  QPUCs  in  cascade  provide  up  to  eight 
independent  data  channels.  The  final  output  of  the  cascaded  pair  interfaces 
directly  with  the  D/A  converter  to  create  a  multi-channel  analog  waveform. 

The  key  performance  parameters  of  the  QPUCs  are: 
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Parameter 

Value 

Input  Sample  Rate  Resolution 

330x10'^  Hz 

Interpolation  Rate  Range 

16  to  >65536 

Max  Individual  Channel  Bandwidth 

3.5  MHz  (60  dB  stopband) 

Max  Individual  Channel  Data  Rate 

5.8  Msps  (complex) 

Max  Poly-channel  Bandwidth 

8.6  MHz  (60  dB  stopband) 

Max  Poly-channel  Data  Rate 

17.2Msps  (complex) 

Resampler  Type 

Non-integer 

Filter  Bandwidth  Range 

<1  kHz  to  8.6  MHz 

Maximum  User  FIR  Taps 

256 

Gain  (Attenuation)  Range 

144  dB 

Carrier  Tuning  Accuracy  (93  Msps) 

0.02  Hz 

Output  Sample  Rate 

93  Msps 

Table  3-1.  Key  performance  parameters  of  the  QPUCs 


Figure  3-4.  QPUC  implementation  (From  Ref.  7). 


Afunctional  block  diagram  of  the  QUPCs  is  shown  in  Figure  3.5. 

Real 


Figure  3-5.  QPUC  channel  functional  diagram  (From  Ref.  7). 
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The  function  of  the  several  stages  is  described  below: 


Input  Data.  The  QPUC  operates  on  a  32-bit  (16-bit  I  and  16-bit  Q) 
complex  input  sample  stream.  Data  is  transferred  form  the  transmitter  data  buffer 
at  a  rate  determined  by  the  timing  NCO.  In  FM  mode,  the  QPUC  uses  the  I  data 
path  to  process  frequency  samples. 

Timing  NCO.  The  QPUC  features  a  48-bit  timing  NCQ  driven  interpolator. 
This  high  precision  interpolator  enables  either  an  integer  or  non-integer 
relationship  to  be  established  between  the  input  and  output  sample  rates.  This 
feature  provides  for  the  selection  of  almost  any  input  sample  rate,  even  with  a 
fixed  93-MHz  output. 

Shaping  Filter.  The  shaping  filter  tailors  the  complex  symbol  shape  via  a 
user  configured  FIR  filter  of  up  to  256  taps  in  length.  The  number  of  user  taps 
available  is  dependent  on  the  ratio  of  output  to  input  rates,  the  higher  the  ratio 
the  more  taps  available.  The  shaping  filter  must  be  a  lowpass  implementation 
and  provide  sufficient  rejection  to  suppress  images  generated  by  subsequent 
interpolation  stages. 

FM  Modulator.  Each  QPUC  channel  contains  an  FM  modulator  that  can 
be  configured  to  operate  before  the  shaping  filter  to  bandlimit  the  FM  output,  or 
after  the  shaping  filter  to  provide  shaped  symbols  into  the  FM  modulator.  In 
bandlimited  FM  mode  the  I  channel  is  used  to  directly  modulate  the  channel 
carrier,  in  shaped  pulse  mode  the  output  of  the  shaping  filter  is  used  to  frequency 
modulate  the  carrier. 

Gain  Profiler.  The  gain  profile  function  is  currently  unavailable  for  use  by 
the  transmitter. 
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Halfband  and  Interpolation  Filter.  The  QPUC  provides  a  fixed  11-tap 
halfband  filter  and  a  timing  NCO  driven  interpolator  for  data  resampling  and  rate 
conversion  up  to  the  final  output  sample  rate. 

Carrier  NCO/Quadrature  Tuner.  The  carrier  NCO  provides  sub-Hertz 
tuning  resolution  for  each  channel  output  using  a  32-bit  phase  accumulator.  It 
features  a  pre-set  phase  offset  and  synchronization  capability.  The  carrier  NCO 
is  modulated  with  the  digital  input  data  using  a  quadrature  mixer.  The  real 
component  of  the  quadrature  mixer  with  the  form  lcos{0)  +  Qs\r\{0)  is  fed 
through  the  gain  control  section  to  the  D/A  converter. 

Gain  Controiier.  Each  channel  contains  a  gain  control  section  that 
provides  for  attenuation  of  the  transmitted  output  over  a  range  from  0.0026  to 
144  dB.  A  user-commanded  scaling  multiplier  implements  the  gain  control 
function  using  a  12-bit  gain  value  and  3-bit  shift  code. 

Channel  Summer.  The  four  QPUC  channel  outputs  are  combined  in  the 
Channel  Summer  along  with  the  cascaded  QPUC  output  to  create  a  real  eight- 
channel  composite  data  stream  for  the  D/A  converter. 

The  two  Intersil  ISL5217  QPUC  chips  are  labeled  QPUC-A  and  QPUC-B 
for  reference  in  the  memory  map.  The  user  has  access  to  all  control  and  data 
functions  through  the  "QPUC-A"  Command/Status  Interface  and  "QPUC-B" 
Command/Status  Interface  registers.  Access  to  the  coefficient  and  gain 
memories  in  the  QPUC  are  performed  using  the  indirect  addressing  method 
described  in  Ref.  8. 

3.  Digital-To-Analog  Converter 

The  QPUC  digital  output  drives  a  14-bit  D/A  converter  to  generate  an 
analog  signal.  The  D/A  converter  is  operated  at  a  fixed  rate  of  93  MHz.  The 
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primary  D/A  performance  parameters  are  listed  in  the  following  table: 


Parameter 

Value  (typical) 

Resolution 

14  bits 

Sample  Rate 

93  Msps 

SFDR 

63dBc 

SFDR  (4  MHz  window) 

SOdBc 

SNR 

70  dB 

Table  3-2.  DAC  performance  parameters 

4.  Transmitter  Front-End 

The  D/A  output  passes  through  a  9-pole  Chebyshev  40  MHz  lowpass 
reconstruction  filter  prior  to  a  final  buffer  amplifier.  The  functional  diagram  of  the 
front-end  is  given  in  Figure  3-6: 


40  MHz 
LPF 

3dB 

Pad 

TXOut 

J 

9-pole 

^  *v 

/ 

Chebyshev 

Figure  3-6.  WaveRunner  transmitter  front-end  (From  Ref.  7). 

The  main  parameters  of  the  transmitter  are  described  in  the  table  below: 


Parameter 

Value 

Sample  Clock  Rate 

93  MHz 

Phase  Noise  (Internal  Sample  Clock) 

-80  dBc/Hz  @  10  kHz  offset 

Internal  Reference  Clock  Stability 

+/-  2.5  ppm  (@1 0  MHz,  -20  to  +70  C) 

Spur  Free  Dynamic  Range 

75  dB 

Frequency  Range  (3  dB) 

0.1  to  40  MHz 

Full-scale  Output  Power  (50  Ohms) 

-12  dBm 

Table  3-3.  Transmitter  main  parameters 
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D. 


RECEIVER  DATAPATH 


The  receiver  is  comprised  of  four  primary  elements: 

•  The  Receiver  Front-End 

•  One  A/D  Converter 

•  Two  Dual  Quad  Programmable  Digital  Downconverter  (QPDC) 

•  The  Receiver  Data  Buffer 

A  diagram  of  the  receiver  datapath  is  shown  in  Figure  3-7.  An  explanation 
of  the  operation  of  each  stage  of  the  receiver,  is  given  in  the  following 
paragraphs. 


Receiver  Data  Buffer 


Figure  3-7.  WaveRunner  253  Receiver  Block  Diagram  (From  Ref.  7). 


1.  Receiver  Front-End 

The  receiver  front-end  amplifies  and  filters  the  analog  input  signal  in 
preparation  for  A/D  conversion.  The  front-end  is  made  up  of  a  digitally  controlled 
attenuator,  low-noise  amplifier  (LNA),  and  a  filter  element. 

The  attenuator  is  commanded  over  the  PCI  bus  using  the  Attenuator 
Power  Control  register.  The  8-bit  control  value  can  be  varied  from  decimal  255 
(no  relative  attenuation)  to  0  (>70  dB  relative  attenuation).  The  attenuator  can  be 
used  as  part  of  software  automatic  gain  control  (AGO)  circuit  to  control  the  input 
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level  to  the  A/D  converter,  the  attenuator  provides  precise  amplitude  control  over 
the  first  20  dB  of  operating  range.  The  attenuator  curve  begins  to  drop  steeply 
after  the  20  dB  point. 

The  LNA  is  used  to  set  the  noise  figure  of  the  receiver  and  help  drive  the 
input  to  the  A/D  converter.  The  added  amplification  eases  the  signal  power 
requirements  for  systems  interfacing  to  the  receiver. 

The  filter  is  implemented  as  a  7-pole  Chebyshev  lowpass  filter  with  a 
cutoff  frequency  of  40  MHz.  The  lower  frequency  limit  of  3  MHz  is  dictated  by  the 
RF  transformer  used  to  couple  the  signal  into  the  A/D  converter. 


The  key  parameters  of  the  RF  front-end  are: 


Parameter 

Value 

Analog  Attenuation  Range 

20  dB  (precision)  70  dB  total 

Maximum  Input  No  damage 

+  15  dBm  (minimum  attenuation) 

Sample  Clock  Rate 

93  MHz 

Phase  Noise  (Internal  Sample  Clock) 

-82  dBc/Hz  @  10  kHz  offset 

Internal  Reference  Clock  Stability 

+/-  1.5  ppm  (@10  MHz,  -20  to  +70  C) 

Linear  Dynamic  Range  (1  MHz  bandwidth) 

90  dB 

IMD  Rejection 

75  dB  (typical) 

Frequency  Range  (3  dB) 

0.1  to  40  MHz 

Full-scale  Input  Power  (50  Ohms) 

-14dBm  (minimum  attenuation) 

Noise  Figure 

7.9  dB 

Input  Third  Order  Intercept  (IIP3) 

+6.2  dBm  (minimum  attenuation) 

IMD  Rejection 

80  dB  (typical) 

Table  3-4.  RF-Front-end  key  parameters 


2.  Analog-To-Digital  Converter 

The  receiver  signal  is  sampled  using  a  14-bit  A/D  converter  that  can  be 
used  in  either  bandpass  or  baseband  operating  mode.  The  A/D  operates  at  a 
fixed  rate  of  93  MHz  with  a  resolution  of  14  bits. 
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3. 


Dual  Quad  Programmable  Digital  Downconverter  (QPDC) 


Two  Intersil  ISL5216  QPDC  chips  perform  the  digital  receiver  tuning  and 
filtering  functions.  The  digital  downconverter  is  one  of  the  key  receiver  signal 
conditioning  components  in  a  software  radio  system.  It  can  be  configured  directly 
from  user  application  code  to  form  carrier  and  symbol  recovery  loops  as  well  as 
other  critical  demodulation  functions  as  part  of  software  defined  radio. 

The  dual  QPDCs  provide  up  to  eight  independent  data  channels  as  shown 
in  Figure  3-8.  The  QPDC  accepts  raw  sample  data  directly  from  the  A/D 
converter  and  performs  the  compute  intensive  tasks  of  tuning,  filtering, 
decimation,  gain  control,  and  re-sampling. 


Figure  3-8.  WaveRunner  253  QPDC  configuration  (From  Ref.  7). 

Some  of  the  key  performance  parameters  of  the  QPDC  are  listed  in  the 
following  table: 
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Parameter 

Value 

Input  Sample  Rate 

93  Msps 

Carrier  Tuning  Accuracy  (93Msps) 

0.02  Hz 

Decimation  Rate  Range 

4  to  more  than  65536 

Max  Individual  Channel  Bandwidth 

3.5  MHz  (60dB  stopband) 

Max  Individual  Channel  Data  Rate 

5.8  Msps  (complex) 

Max  Poly-channel  Bandwidth 

8.6  MHz  (60dB  stopband) 

Max  Poly-channel  Data  Rate 

23.2  Msps  (complex) 

Filter  Bandwidth  Range 

<1  kHz  to  8.6  MHz 

Maximum  User  FIR  Taps 

256  typical,  384  max 

Maximum  FIR  Filter  Rejection 

110dB 

AGC  Range 

96  dB 

Output  Sample  Rate  Resolution 

-9 

1.29x10  Hz 

Resampler  Type 

Integer  and  Non-integer 

Output  Formats 

I,  Q,  Mag,  Phase,  Frequency 

Table  3-5.  Key  performance  parameters  of  the  QPDCs 


A  functional  block  diagram  of  a  single  QPDC  channel  is  shown  in  Figure 
3-9.  Each  channel  implements  a  sub-band  tuning  architecture  by  tuning  a  narrow 
filter  to  a  selected  point  in  the  A/D  converter  passband. 


MsQ.  prase 
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Figure  3-9.  QPDC  Block  diagram  (From  Ref.  7). 


The  major  elements  of  the  QPDC  channel  are: 

•  Input  Level  Detector  (not  shown) 

•  Carrier  Numerically  Controlled  Qscillator  (NCQ)/Quadrature  Tuner 

•  Cascaded  Integrator  Comb  (CIC)  Filter 
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•  Filter  Compute  Engine/Resampler 

•  Timing  (symbol)  NCO 

•  AGC 

•  Cartesian-to-Polar  Converter  (Magnitude,  Phase,  Frequency) 

The  following  paragraphs  provide  a  brief  overview  of  QPDC  functionality: 

Input  Level  Detector.  The  input  level  detector  monitors  data  as  it  enters 
the  QPDC  and  provides  three  averaging  modes  for  determining  the  input  signal 
magnitude  in  the  A/D  converter.  The  three  modes  supported  are  integration, 
leaky  integration,  and  peak  detection.  The  information  from  the  level  detector  can 
be  used  to  adjust  the  analog  gain  as  part  of  a  software  AGC  loop. 

Carrier  NCO/Quadrature  Tuner.  The  tuning  function  is  implemented 
using  an  NCO  and  quadrature  mixer.  The  NCO  phase  accumulator  is  32  bits 
wide,  allowing  for  sub-Flertz  tuning  accuracy  and  very  low  (-115  dB)  spurious 
response. 

CIC  Filter.  The  CIC  filter  is  the  first  signal  conditioning  element  in  the 
QPDC  processing  chain.  The  overall  shape  of  the  processing  band  is  determined 
through  a  combination  of  the  CIC  section  and  components  of  the  filter  compute 
engine:  half  band,  FIR,  and  resampler. 

The  CIC  filter  has  a  sin(x)/x  characteristic  as  shown  in  Figure  3-10.  It  is 
an  extremely  efficient  filter  and  is  used  to  extract  a  band  of  interest  and  drop  the 
sample  rate  prior  to  precision  filtering  in  the  Filter  Compute  Engine  section. 

Filter  Compute  Engine  (FCE).  The  purpose  of  the  FCE  section  is  to  fine 
tune  the  processed  signal  spectrum  created  by  the  CIC  filter.  The  FCE  provides 
a  variety  of  user-configurable  filters  including  a  series  of  fixed  half-band  filters 
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and  a  user-programmable  finite  impulse  response  (FIR)  filter.  The  frequency 
response  of  the  built-in  halfband  filters  is  shown  in  Figure  3-11.  The  FCE  also 
provides  for  non-integer  resampling  using  a  polyphase  filter  in  concert  with  a 
precision  timing  NCO.  The  FCE  has  a  built-in  controller  used  to  chain  together 
filter  and  decimation  stages  to  create  a  precisely  conditioned  signal  with  an  exact 
shape,  bandwidth,  and  sample  rate.  An  example  of  a  composite  filter  created 
from  the  CIC  and  FCE  combination  is  shown  in  Figure  3-12. 


Figure  3-10.  CIC  characteristics,  (a)  Passband  rolloff  ( A/ =  Number  of  stages, 
R=decimation  factor,  4=sampling  frequency),  (b)  5'-'^  order 
{N  =  5)  CIC  filter  response  (From  Ref.  8). 


Figure  3-11.  Frequency  response  of  the  built-in  halfband  filters  (From  Ref.  8). 
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Timing  (symboi)  NCO.  The  QPDC  features  a  high  resolution  (56-bit) 
timing  NCO  that,  when  used  with  the  resampler,  provides  the  user  with  the 
capability  to  generate  precise  output  sample  rates  independent  of  the  QPDC 
input  sample  rate. 


Single  Channel  Composite  Filter  Frequency  Response 


Figure  3-12.  Composite  filter  example  (CIC  +  FIR)  (From  Ref.  7). 


AGC.  A  full  featured  AGC  loop  is  built  into  the  QPDC  for  high  performance 
signal  level  control.  The  AGC  loop  can  be  used  to  extract  small  signals  from 
noise  after  large  signals  and  out-of-band  noise  have  been  filtered  by  the  CIC  and 
FIR  filter  sections.  The  AGC  loop  operates  on  24-bit  data  emanating  from  the 
FCE  to  provide  up  to  96  dB  of  dynamic  range. 

Cartesian-to-Polar  Converter  (Magnitude,  Phase,  Frequency).  The 

last  section  of  the  QPDC  contains  a  Cartesian-to-Polar  (CTP)  converter.  The 
CTP  converts  data  from  complex  I  and  Q  format  to  a  polar  form  made  up  of 
magnitude  and  phase.  Both  data  formats  are  available  to  the  user  to  save 
software  overhead  in  converting  between  the  two  systems.  The  QPDC  also 
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contains  a  frequency  discriminator  that  can  be  used  to  directly  output  frequency 
measurements. 

QPDC  Command/Status.  The  two  Intersil  ISL5216  QPDC  chips  are 
labeled  QPDC-A  and  QPDC-B  for  reference  in  the  memory  map.  All  the  QPDC 
configuration  registers  are  user  accessible  through  the  QPDC-A 
Command/Status  Interface  and  QPDC-B  Command/Status  Interface  registers 
(Ref.  8). 

4.  Receiver  Data  Buffer 

The  receiver  has  a  dedicated  256  kbytes  buffer  capable  of  storing  64 
ksamples  of  complex  data  (16-bit  I,  16-bit  Q).  The  buffer  acts  as  a  FIFO  to 
perform  data  rate  translation  between  the  QPDC  outputs  and  the  PCI  bus.  The 
buffer  operates  as  a  multi-queue  FIFO  that  can  be  organized  into  a  variety  of 
configurations  from  a  single  large  queue  occupying  all  256  kbytes  to  eight 
smaller  queues  of  varying  size.  This  flexibility  provides  the  user  ultimate  control 
over  data  flow  and  can  be  used  to  tailor  the  memory  to  different  channel  rates 
and  bandwidths. 

E.  CONTROLLER 

The  controller  performs  all  local  command  and  control  functions  while  also 
acting  as  an  interface  to  the  host  computer.  It  communicates  with  the  host  over 
an  interface  compliant  with  the  PCI  Local  Bus  Specification  (66  MFIz).  The 
interface  supports  both  32-  and  64-bit  transactions  operating  at  either  33  or  66 
MHz. 


The  controller  occupies  2  Mbytes  of  memory  space  accessed  from  a 
single  base  address  register  and  is  connected  to  PCI  Interrupt  A  on  the  bus.  The 
PCI  bus  serves  as  the  primary  control  and  data  interface  to  the  card.  The  local 
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controller  can  operate  as  a  master  or  target,  with  the  ability  to  automatically 
initiate  DMA  transfers  of  data  between  the  transceiver  buffers  and  host  memory. 

Interrupt  Control  /  Status.  A  comprehensive  set  of  interrupt  enable  and 
status  registers  are  available  to  support  data  movement  and  alert  the  host  to 
error  conditions.  Interrupt  conditions  are  reported  through  the  Interrupt  Status 
and  Rx/Tx  FIFO  Interrupt  Status  registers.  All  interrupt  flags  are  "trapped"  and 
held  until  an  interrupt  status  read  occurs  which  clears  the  flags  in  the  respective 
register. 

Buffer  Configuration.  Separate  256-kbytes  (64-bit  by  32k)  buffers  are 
dedicated  to  the  receive  and  transmit  datapaths.  The  buffers  can  be  accessed 
directly  through  32-  or  64-bit  single  or  burst  transfers  over  the  PCI  bus. 

Memory  Area  Definition.  Both  the  receive  and  transmit  buffers  can  be 
partitioned  as  one  to  eight  distinct  memory  areas  that  are  assigned  to  a 
corresponding  number  of  QPDC  and  QPUC  channels.  Each  Memory  Area  looks 
like  an  independent  FIFO  to  the  PCI  bus  interface.  The  Memory  Areas  can  be 
arbitrarily  sized  on  8-byte  boundaries  to  load  balance  channels  with  different  data 
rates.  The  controller  maintains  read  and  write  pointers  to  keep  track  of  the  next 
address  to  be  accessed. 

Channel  Assignment.  The  QPDCs  and  QPUCs  can  be  configured  to 
process  eight  channels  separately  or  to  polyphase  multiple  (>2)  channels 
together.  If  they  are  configured  as  eight  independent  channels,  the  controller 
transfers  data  between  each  channel  and  the  uniquely  assigned  Memory  Area. 
When  they  are  configured  to  polyphase  multiple  channels  together,  data  from 
groups  of  channels  need  to  access  the  same  Memory  Area. 

DMA  Transfers.  The  controller  can  transfer  data  to/from  the  host  memory 
using  manual  or  automatic  direct  memory  access  (DMA).  Manual  DMA  transfers 
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require  the  user  to  initiate  the  DMA  transfer  by  writing  to  several  registers. 
Manual  DMAs  are  typically  initiated  when  a  Memory  Area  FIFO  generates  an 
over  threshold  interrupt.  When  Automatic  DMA  is  used,  the  controller  monitors 
the  status  of  the  memory  FIFO  thresholds.  When  a  threshold  is  exceeded,  the 
controller  automatically  initiates  a  DMA  transfer  to/from  a  user  specified  memory 
location.  Automatic  DMA  also  has  a  provision  for  notifying  the  host  process  via 
an  interrupt  that  the  previously  specified  number  of  DMA  transfers  have  been 
completed. 

DMA  Chaining.  The  Automatic  DMA  function  is  supplemented  by  a  DMA 
chaining  feature  that  allows  the  controller  to  transfer  data  to/from  a  circular  buffer 
in  host  memory  without  processor  intervention.  The  Auto  DMA  Block  Count  and 
Auto  DMA  Address  registers  remain  static  when  this  feature  is  enabled.  An 
interrupt  is  still  issued  when  transfer  of  the  final  data  block  completes,  but  the 
controller  will  continue  to  transfer  data  to/from  the  next  sequential  address  in  host 
memory  instead  of  loading  a  new  address. 

More  extensive  description  of  the  the  channel  configuration  will  follow  at 
the  next  chapter,  because  the  details  of  these  characteristics  are  the  main  area 
of  interest  for  the  implementation  of  our  software. 

F.  FROM  HERE  ... 

The  current  chapter  has  outlined  a  brief  description  of  the  characteristics 
of  the  hardware  we  are  using.  Indeed  the  capabilities  of  the  hardware  are  vast. 
Here  we  have  described  only  a  part  of  them,  only  those  that  are  going  to  be 
useful  to  our  work. 

Now,  we  are  ready  to  proceed  to  the  next  chapter  which  constitutes  the 
actual  work  that  has  been  performed:  the  description  of  the  software  developed 
by  the  author. 
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IV:  DESCRIPTION  OF  THE  SOFTWARE 


A.  INTRODUCTION 

In  the  previous  chapters  we  examined  some  aspects  of  the  theoretical 
background  of  the  Software  Defined  Radio  technology,  as  well  as  the  specific 
architecture  of  the  hardware  we  used  in  our  effort  to  implement  the  SDR  datalink. 

Now  it  is  time  to  describe  the  actual  work  that  was  done  during  this  thesis. 
This  work  actually  consisted  of  two  parts: 

•  Configuration  and  manipulation  of  the  hardware 

•  Data  organization  in  order  to  achieve  successful  and  meaningful 
communication. 

The  first  one  of  the  above  two  parts  was  actually  the  most  rigorous  one.  It 
can  be  analyzed  in  the  following  tasks: 

•  Channel  configuration 

•  Hardware  initialization  -  configuration 

•  Data  exchange  administration 

In  order  to  implement  the  above  described  functionality,  significant  amount 
of  code  was  written  in  C++,  using  the  Microsoft  Visual  C++  language,  which 
constitutes  a  part  of  the  Visual  Studio  .NET  programming  suite.  The  channel 
configuration  was  performed  using  a  dedicated  configuration  tool  provided  by  the 
manufacturer. 

The  following  paragraphs  describe  in  detail  all  the  work  that  has  been 
carried  out. 
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B.  HARDWARE  LIBRARY  AND  DATA  TRANSFER  MODE 


The  hardware  we  used  was  accompanied  by  a  driver  for  the  Windows 
operating  system  and  a  library  of  functions,  through  which  the  application  could 
access  and  program  the  card.  These  functions  covered  a  variety  of  tasks: 
opening  and  closing  the  card,  allocating  memory,  configuring  the  PCI  address 
space,  reading  from  and  writing  to  specific  card  registers.  The  library  was 
incorporated  into  the  application  code. 

After  the  card  has  been  configured,  data  transfer  between  the  host 
computer  allocated  memory  and  the  card  buffers  takes  place  automatically 
without  user  intervention,  taking  advantage  of  the  DMA  chaining  mode.  During 
this  mode  the  user  defines  the  parameters  of  the  transfers  (groups  per  channel, 
blocks  per  group,  symbols  per  block,  memory  areas-limits-starting  and  ending 
offsets)  and  the  DMA  address  is  incremented  automatically  every  time  a  symbol 
is  transferred,  until  it  reaches  the  end  of  the  memory  segment  allocated  to  a 
specific  channel.  At  that  point,  the  DMA  address  is  reset  to  its  original  value.  In 
this  way,  the  channel  memory  is  used  as  a  circular  buffer  containing  two  or  more 
groups.  When  the  card  is  accessing  one  of  the  groups,  the  host  computer  is 
accessing  another  one.  It  is  obvious  that  the  data  transfer  rate  between  the  host 
computer  memory  and  the  storage  medium  (for  example  the  hard  disk)  must  be 
at  least  as  fast  as  the  transfer  rate  between  the  card  and  the  host  memory.  This 
is  the  critical  factor  for  the  performance  of  the  system.  When  a  group  of  data  has 
to  be  transferred  to  or  from  the  host  computer  memory,  the  card  notifies  the  host 
computer  by  raising  the  appropriate  interrupt.  The  application  responds  to  the 
interrupt  and  takes  the  appropriate  action  via  an  interrupt  Service  Routine.  A 
dummy  routine  is  provided  in  the  card  library,  which  does  practically  nothing.  One 
of  the  tasks  of  the  user  application  is  to  override  this  function  with  a  more 
meaningful  one. 
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C.  CHANNELS  CONFIGURATION 

The  configuration  of  the  WaveRunner  channels  actually  consists  of  two 

parts: 

•  Configuration  of  the  Upconverter  (DUC)  and  Downconverter  (DDC) 
integrated  circuits  with  all  the  parameters  of  the  channels:  center 
frequencies,  datarates,  upconversion  and  downconversion  rates, 
programming  of  the  shaping  filter  of  the  transmitter  and  the  FIR  filters 
of  the  receiver,  data  exchange  between  the  converters  and  the  card 
memory,  possible  combinations  of  the  DDC  circuits  in  the  case  of 
polyphase  channel  organization  e.t.c. 

•  Configuration  of  the  main  memory  of  the  card  in  respect  to  the  number 
of  reception  and  transmission  channels  selected  by  the  user. 

Both  the  above  tasks  can  be  performed  using  the  WaveFormer  II 
configuration  utility.  This  utility  consists  of  a  series  of  Excel  spreadsheets 
organized  in  a  hierarchical  manner,  giving  to  the  user  access  to  all  the  registers 
of  the  hardware.  After  the  user  has  chosen  all  the  desirable  values,  three  C 
header  files  are  produced,  which  can  be  uploaded  to  the  hardware  by  the  user 
application. 

However,  the  drawback  of  the  above  procedure  is  that  each  time  one 
parameter  needs  to  be  modified,  the  user  must  open  and  re-run  the  utility, 
compile  and  reload  the  files.  Since  the  author’s  belief  was  that  the  true  value  of 
the  software  radio  resides  on  its  adaptability,  the  user  should  have  a  maximum 
degree  of  flexibility  and  should  be  able  to  change  some  parameters  “on  the  fly”. 
The  flexibility  that  was  decided  to  be  available  through  the  application  that  would 
be  developed,  was  the  arbitrary  choice  of  the  number  of  active  reception  and 
transmission  channels,  center  frequencies,  datarates  and  modulation  types.  All  of 
the  above  tasks  would  be  administered  solely  by  software. 
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In  order  to  implement  the  above,  only  the  DUC  and  DDC  configuration 
was  decided  to  be  performed  with  the  use  of  the  configuration  tool,  because  it 
was  fairly  complicated  and  the  time  restrictions  of  this  thesis  prohibited  the 
implementation  of  the  above  functionality  in  C++.  On  the  other  hand,  the 
organization  of  the  card  memory,  which  would  depend  on  the  number  of  active 
channels  selected  by  the  user,  as  well  as  the  administration  of  the  data  exchange 
between  the  card  and  the  host  computer,  would  be  implemented  by  the  C++ 
application. 

Figures  4-1  to  4-4  show  several  snapshots  of  the  configuration  utility.  It 
can  be  clearly  seen  that  a  multitude  of  parameters  can  be  set  with  this  utility. 
After  all  parameters  are  set,  the  user  returns  to  the  main  screen  and  creates  the 
header  files. 


WaveFormer  II 


Version:  RS.02 


IF  OUTPUT 


Baseband 


Build  Config  Files 
A»  I 

Board 

Tx 

Rx 

File  Tag.  ^Default 

View  Memory 
Map 


Vendor  ID:  0x1 7D2 
E>evice  ID:  (bc0301 


Figure  4-1.  Main  screen  of  the  WaveFormer  configuration  Tool. 
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Figure  4-2.  Reception  channel  configuration  screen. 
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Figure  4-3.  Configuration  of  one  of  the  filters  of  the  DDC  FIR  engine. 
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Figure  4-4.  Memory  organization  for  the  transmission  channels. 


D.  APPLICATION  GUI 

As  we  have  already  mentioned,  an  application  was  created  by  the  author 
using  the  Microsoft  Visual  C++  language.  On  the  top  of  this  application  lies  a 
Graphical  User  Interface  (GUI)  which,  through  a  series  of  screens,  lets  the  user 
input  all  the  desired  parameters  of  the  communications:  number  of  active 
channels,  center  frequencies,  modulation  types  and  datarates. 

Figures  4-5  to  4-7  show  the  basic  screens  of  the  application  GUI.  It 
actually  consists  of  three  pages: 

•  Main  page:  In  this  page  the  user  chooses  the  number  of  active 
channels  and  the  location  of  the  configuration  file  (which  has  already 
been  produced  by  the  WaveFormer  configuration  tool).  After 
configuring  all  the  features  of  the  active  Rx  and  Tx  channels  in  the 
following  two  pages,  the  user  presses  the  Start  Rx/Tx  button  and  the 
card  is  activated  starting  the  communication.  The  user  can  be 
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informed  on  the  status  and  progress  of  each  active  channel,  by  the 
progress  bars  and  text  boxes  at  the  lower  half  of  the  page. 

•  Rx  channels  configuration  page.  From  this  page,  the  user  can 
define  the  following  parameters  for  each  active  Rx  channel:  center 
frequency,  modulation  type,  number  of  samples  per  symbol  (more 
about  this  later)  and  location  of  the  file  to  store  the  demodulated  data. 

•  Tx  channels  configuration  page.  In  the  same  manner  as  in  the 
previous  page,  the  user  can  define  the  following  parameters  for  each 
active  Tx  channel;  center  frequency,  modulation  type,  datarate, 
location  of  the  file  to  retrieve  the  data  to  be  transmitted  and 
attenuation  of  the  transmitted  signal  (in  terms  of  its  maximum  possible 
power). 


Figure  4-5.  Communications  Control  Panel  main  page. 
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Figure  4-6.  Communications  Control  Panel  Rx  channels  configuration  space. 


Figure  4-7.  Communications  Control  Panel  Tx  channels  configuration  space. 
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E. 


APPLICATION  ARCHITECTURE 


In  the  previous  paragraphs  we  described  the  user  interface  of  our 
application:  what  the  user  sees  and  how  he  interacts  with  the  application. 
However,  the  quintessence  of  the  code  lies  on  what  takes  place  after  the  user 
has  pressed  the  Start  Rx/Tx  button:  the  procedures  that  were  developed  in  order 
to  achieve  successful  communication  and  data  exchange  between  the 
transceiver  and  the  host  computer.  These  procedures  are  described  extensively 
in  the  following  paragraphs. 

1.  Objects 

Since  the  application  is  purely  object  oriented,  a  series  of  classes  were 
created,  each  of  them  containing  all  the  necessary  functionality  in  order  to 
achieve  specific  tasks.  The  main  classes  of  the  application  are  described  in  the 
following  paragraphs.  For  each  object,  a  table  summarizes  its  main  variables  and 
functions. 


WaveRunner.  This  class  encapsulates  the  functionality  of  the  card.  Only 
one  instance  of  this  class  can  be  created  in  the  application  using  the  Singleton 
pattern  (Ref.  6).  The  class  also  incorporates  the  objects  encapsulating  the 


functionality  of  the  channels  (they  will  be  described  later  in  this  paragraph). 


Class  WaveRunner 

Main  Variables 

Const 

maxChannels 

Number  of  maximum  available  channels 

rxClockFrequency 

Frequency  of  the  receiver  circuit 

txClockFrequency 

Frequency  of  the  transmitter  circuit 

blockSize 

Size  in  4-byte  words  of  a  block  of  data 

rxBlocksPer Group; 
rxGroupsPerChannel ; 
rxThresholdGroups ; 
rxChannelSize; 

L  Reception  organization  parameters 

txBlocksPer Group; 
txGroupsPerChannel ; 

Transmission  organization  parameters 
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txThresholdGroups ; 

txChannelSize; 

memorySize; 

IDMAvAddress ; 
IDMApAddress ; 
rxChannel [maxChannels  ] 
txChannel [maxChannels] 
rxThredsRunning 
txThreadsRunning 
txChanne Is Count ; 
rxChanne Is Count ; 
rxChanne Is Con figured; 
txChanne Is Con figured; 
rxTxEnable 

Transmission  organization  parameters 

Size  of  host  computer  memory  allocated  to  the 
device 

Virtual  starting  address  of  the  allocated  memory 
Physical  starting  address  of  the  allocated  memory 
Array  of  RxChannel  pointers 

Array  of  TxChannel  pointers 

Number  of  active  reception  threads 

Number  of  active  transmission  threads 

Number  of  selected  active  transmission  channels 
Number  of  selected  active  reception  channels 

Number  of  configured  active  reception  channels 
Number  of  configured  active  transmission  channels 
Boolean  variable  reflecting  the  status  of  the  card 

Main  functions 

get Instance ( ) 

Creation  of  one  and  only  new  WaveRunner  object 

using  the  Singleton  pattern 

Open  ( ) 

Initial  opening  of  the  device 

Close  ( ) 

Closing  of  the  device 

Configure ( ) 

Configuration  of  the  device 

EnableRx ( ) 

Reception  enable  (requires  configuration  first) 

DisableRx ( ) 

Reception  disable 

Enable (Tx) 

Transmission  enable  (requires  configuration  first) 

DisableTx ( ) 

Transmission  disable 

EnableRxTx ( ) 

Reception  and  transmission  enable 

DisableRxTx ( ) 

Reception  and  transmission  disable 

Table  4-1 .  WaveRunner  class  description. 


The  details  of  the  functionality  of  the  WaveRunner  class  functions  will  be 
described  later  in  this  chapter. 

WaveRunnerChannel.  This  is  an  abstract  class.  It  contains  the  main 
common  parameters  of  the  transmission  and  reception  channels.  It  is  the  parent 
class  which  will  be  inherited  to  the  Tx  and  Rx  channel  classes. 
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Class  WaveRunnerChannel 

Main  Variables 

channelNumber  ; 

Number  of  channel  (0-7) 

channelOf f set ; 

Channel  offset  (used  for  programming  the  DUC  and 

DDC  registers) 

frequency; 

Channel  center  frequency 

k; 

Number  of  bits  per  symbol  (for  M-PSK  modulations) 

dataFileN  ame ; 

Name  of  the  file  to  store  or  retrieve  data 

dataRate; 

Channel  datarate  (for  the  Tx  channels)  or  samples 

per  symbol  (for  the  Rx  channels) 

offsetAddress; 

Offset  address  of  the  DDC  or  DUC  registers. 

dataBuffer; 

Pointer  to  the  allocated  memory  of  the  channel 

groupsTransf ered; 

Number  of  transferred  groups  of  data  to/from  the 

transceiver 

groupCount ; 

Counter  of  the  starting  position  on  the  channel 

memory  to  transfer  data. 

terminateProcess ; 

Orders  the  channel  thread  to  be  terminated 

threadRunning; 

Indicates  if  the  channel  thread  is  running 

threadReady ; 

Indicates  if  the  channel  thread  is  ready 

Main  functions 

WaveRunnerChannel () 

Dummy  class  constructor.  No  useful  action  is 

performed. 

Table  4-2.  WaveRunnerChannel  class  description. 


RxChannel.  It  stores  the  functionality  of  a  reception  channel.  It  inherits  all 


the  parameters  of  the  WaveRunnerChannel  c\ass. 


Class  RxChannel 

Main  variables 

groupsSaved 

Number  of  groups  saved  to  the  destination  file 

Main  functions 

RxChannel ( ) 

setFrequency ( ) 

Class  constructor.  Initializes  all  the  class  parameters.  Calls 

setFrequency ( )  . 

Sets  the  channel  center  frequency  by  writing  to  the 
appropriate  DDC  register. 

1 

fable  4-3.  RxChannel  class  description. 

TxChannel.  It  incorporates  the  functionality  of  a  Tx  channel.  It  also 
inherits  all  the  parameters  of  the  WaveRunnerChannel  class. 
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Class  TxChannel 

Main  variables 

groupsLoaded 

Number  of  groups  loaded  from  the  Tx  file. 

attenuation 

Attenuation  in  dB  of  the  transmitted  data 

Main  functions 

TxChannel  ( ) 

Class  constructor.  Initializes  all  the  class  parameters. 

setFrequency ( ) 

Sets  the  center  frequency  of  the  channel  by  writing  to  the 

appropriate  DUC  register 

setDataRate ( ) 

Sets  the  datarate  of  the  channel  by  writing  to  the 

appropriate  DUC  register. 

Table  4-4.  TxChannel  class  description. 


Apart  from  the  above  classes,  the  application  uses  four  other  classes  in 
order  to  implement  the  GUI.  The  first  one  of  them  is  the  CommsCtrlDIg  class.  It 
is  a  CPropertySheet  class  and  serves  as  the  nesting  class  for  the  three  classes, 
CommsTabI,  CommsTab2  and  CommsTabS.  These  three  classes  are  of  the 
CPropeiiyPage  type,  each  one  of  them  incorporating  the  functionality  of  the 
corresponding  page  of  the  communication  control  panel.  Through  a  series  of  text 
boxes,  combo  boxes,  property  sheets,  buttons  and  message  boxes,  the  above 
classes  ensure  that  the  user  has  entered  the  correct  parameters.  Also,  while  the 
card  is  active,  the  user  is  informed  on  the  process  and  status  of  all  the  active 
channels. 


The  implementation  of  these  classes  constitutes  a  significant  portion  of  the 
application  code.  However,  since  their  functionality  is  common  C++  functionality 
and  not  directly  connected  to  the  subject  of  this  thesis,  it  was  considered  better 
not  to  describe  them  analytically  in  this  text.  Their  code  is  included  in  the  listing  of 
the  application  code  at  the  appendix  of  this  thesis. 

2.  Procedures 


Hardware  initialization  (Figure  4-8a).  When  the  application  starts,  an 
object  of  the  WaveRunner  c\ass  is  created.  As  a  part  of  its  initialization  code,  the 
object  checks  to  see  if  the  card  is  present,  by  executing  the  OpenWaveRunnerQ 
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command  from  the  library.  If  this  is  the  situation,  the  hardware  initialization  takes 
place,  by  executing  the  WaveRunner::Open()  function.  The  routine  initializes  the 
channel  objects,  allocates  host  computer  memory  and  distributes  it  to  the 
channel  objects,  resets  the  card  interrupt  register  and  DMA  Transfer  register, 
resets  the  DUCs  and  the  DDCs  and  exits. 


After  that  the  application  waits  for  the  user  to  enter  the  appropriate 


parameters  and  hit  the  Start  Rx/Tx  button. 


Wait  for 
configuration 


Start  ) 


(a) 


(b) 


Figure  4-8.  (a)  Hardware  initialization  procedure,  (b)  Hardware  configuration 


procedure. 


Hardware  configuration  (Figure  4-8b).  The  click  of  the  Start  Rx/Tx 
button  changes  its  caption  to  Stop  Rx/Tx  and  invokes  the  master  thread 
mainRxTxThreadQ.  The  first  thing  that  this  thread  does,  is  configure  the 
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hardware  by  invoking  the  WaveRunner::Configure()  function.  The  sequence  of 
configuration  tasks  is  the  following: 


•  The  C  header  files  that  have  been  created  using  the  WaveFormer 
configuration  tool,  are  uploaded  to  the  card  using  the 
ConfigureWaveRunnerQ  command  of  the  library. 

•  The  PCI  configuration  space  is  configured  with  the  number  of  4-byte 
words  per  data  block,  using  the  WriteWRConfigSpaceQ  command 
from  the  library. 

•  For  every  active  transmission  and  reception  channel  the  following 
parameters  are  defined  by  writing  specific  values  to  the  appropriate 
registers: 

•  Starting  address  of  the  channel  memory. 

•  Number  of  data  blocks  per  group  of  data  transfer. 

•  Number  of  groups  per  channel  memory  area. 

•  Channel  memory  area  size,  starting  offset,  ending  offset  and 
threshold  to  raise  an  interrupt. 

•  The  interrupt  mask  register  is  updated  in  order  to  permit 
interrupts  from  the  specific  channel. 

•  The  receive  or  transmit  control  register  is  updated  in  order  to 
service  the  specific  channel 

•  The  Auto  DMA  Transfer  Register  is  updated  in  order  to  perform  data 
transfers  in  the  active  channel  memory  spaces. 

•  The  card  buffers  are  flushed  in  order  to  delete  any  random  data. 

Interrupt  Service  Routine  (Figure  4-9a).  The  application  provides  useful 

behavior  to  the  interrupt  service  routine  by  overriding  the  PMCRadiolsrOQ  routine 

of  the  WaveRunner  library.  When  an  interrupt  occurs,  this  function  is  called  with 

the  contents  of  the  Interrupt  Status  Register  passed  as  a  parameter.  The  routine 
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checks  to  see  if  the  interrupt  is  due  to  the  transceiver.  If  this  is  the  situation,  it 
checks  to  see  if  the  interrupt  is  due  to  a  buffer  abnormal  condition  (overflow  or 
underflow).  In  this  case,  it  updates  the  corresponding  channel  status.  Otherwise, 
the  interrupt  is  due  to  a  completed  data  transfer.  So,  the  appropriate  channel 
event  is  set  (more  about  this  later).  As  a  last  step,  the  routine  re-enables  the 
interrupts  and  exits. 

At  this  point  we  need  to  say  that  the  interrupt  service  routine  must  be  as 
fast  as  possible,  since  it  is  invoked  hundreds  or  even  thousands  of  times  per 
second.  As  long  as  the  routine  is  invoked,  additional  interrupts  are  disabled.  That 
means  that  data  corruption  may  occur.  That  is  the  reason  why  the  routine  only 
signals  the  channel  servicing  routines  that  they  have  to  take  appropriate  action.  It 
is  the  responsibility  of  the  channel  threads  to  take  whatever  action  they  deem 
necessary. 

Main  communication  thread  (Figure  4-9b).  As  we  have  aiready  said,  this 
thread  is  iaunched  when  the  Start  Rx/Tx  button  is  pressed.  The  tasks  that  this 
thread  performs  are  the  foiiowing: 

•  It  calls  the  WaveRunner::Configure()  function,  which  performs  the 
hardware  configuration. 

•  For  each  active  channel,  it  transfers  the  parameters  chosen  by  the 
user,  into  the  WaveRunner  and  the  channel  class  variables. 

•  For  every  active  channel,  it  launches  a  corresponding  rxThreadQ  or 
txThreadQ. 

•  It  waits  until  all  the  active  channels  are  ready  to  transmit  or  receive. 

•  It  enables  the  transmission  and  reception  circuitry  of  the  card.  More 
specifically: 

•  It  enables  interrupts  by  writing  a  one  to  the  Global  Interrupt 
Register. 
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•  It  sets  the  appropriate  bits  of  the  Transmit  Control  and 
Receive  Control  register. 

•  It  enables  the  DMA  data  transfer,  by  setting  the  appropriate 
bit  of  the  Auto  DMA  Register. 

•  It  waits  until  all  the  channels  are  done  transmitting  or  receiving. 

•  It  disables  transmission  and  reception. 

•  It  notifies  the  application  that  the  card  is  no  longer  transmitting  or 
receiving. 


(a)  (b) 

Figure  4-9.  (a)  Interrupt  Service  Routine,  (b)  Main  communications  thread. 
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We  need  to  say  that,  at  the  two  occasions  when  the  master  thread  waits 
for  the  channel  threads  to  signal  an  event,  the  signaling  is  accomplished  via  the 
setting  of  two  events,  the  allChannelsReady  event,  in  order  to  signal  that  all 
channels  are  ready  for  transmission  and  reception  and  the  allChannelsDone 
event,  which  signals  that  all  channels  are  done. 

Just  before  the  routine  exits,  if  the  user  has  not  disabled  reception  or 
transmission  in  the  meantime,  the  thread  posts  a  WM_PROCESS_FINISHED 
user  defined  message  to  the  application  GUI,  in  order  for  the  Start  Rx/Tx  button 
caption  to  return  to  its  original  state. 

Tx  thread  (Figure  4-1  Oa).  This  thread  is  launched  by  the  master  Rx/Tx 
thread,  once  for  every  active  transmission  channel. 

The  first  task  of  the  thread  is  to  create  the  baseband  I  and  Q  symbols  to 
be  transmitted,  from  the  data  file.  It  must  be  noted  that  the  modulation  of  the  data 
takes  place  before  and  not  during  the  actual  transmission.  This  choice  was 
dictated  by  the  fact  that  simultaneous  modulation  and  transmission  might  slow 
the  performance  of  the  system.  The  modulation  process  will  be  described 
analytically  later. 

When  the  modulation  is  over,  the  thread  fills  the  channel  memory  buffer 
with  the  first  set  of  data.  Subsequently,  it  increases  the  WaveRunner:: 
threadsReady  variable.  If  it  is  the  last  active  channel  to  do  so,  it  notifies  the 
master  thread  by  setting  the  allChannelsReady  eyent 

After  the  above  actions,  the  thread  enters  a  loop,  the  first  stage  of  which  is 
a  suspension  of  the  thread  until  the  appropriate  txBufferEmpty  event  has  been 
signaled  by  the  interrupt  service  routine.  The  thread  wakes  up  and  checks  to  see 
if  the  event  was  caused  by  a  buffer  underflow  error.  In  this  case  it  simply  updates 
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its  status  with  the  error  and  exits.  Otherwise,  it  fills  again  the  appropriate  memory 
area  with  data  and  re-enters  the  suspended  state. 

The  above  loop  continues  as  long  as  there  is  more  data  to  transmit  and 
the  user  has  not  cancelled  transmission.  When  either  of  the  two  conditions 
occurs,  the  thread  clears  the  memory  buffer  by  writing  zeroes  to  all  the  memory 
range.  In  this  way,  the  data  retrieved  by  the  card  until  transmission  is  disabled, 
are  simply  zeroes  and  nothing  is  actually  transmitted.  Subsequently  it  updates 
the  channel  status,  decreases  the  WaveRunner::threadsRunning  variable  and 
exits.  If  it  is  the  last  channel  thread  running,  just  before  exiting,  it  notifies  the 
master  thread  by  setting  the  allChannelsDone  event. 

Rx  thread  (Figure  4-1  Ob).  This  thread  is  launched  by  the  master  thread 
once  for  every  active  reception  channel.  Its  functionality  is  similar  to  the 
functionality  of  the  transmission  thread. 

After  having  created  the  file  to  save  the  received  symbols,  the  thread 
increases  the  WaveRunner::threadsReady  variable  and,  if  it  is  the  last  active 
thread  to  do  so,  it  notifies  the  master  thread  by  setting  the  allThreadsReady 
event. 


Subsequently,  it  enters  the  reception  loop.  It  remains  suspended  until 
notified  by  the  appropriate  rxBufferFull  event  by  the  interrupt  service  routine. 
When  awakened,  if  the  user  has  not  cancelled  reception  and  no  buffer  overflow 
error  has  occurred,  it  stores  the  received  symbols  from  the  buffer  memory  to  the 
appropriate  file  and  re-enters  the  suspended  state. 

When  the  user  stops  reception,  an  rxBufferFull  event  is  set  as  well.  The 
loop  exits  and  the  stored  symbols  are  demodulated  into  meaningful  data.  The 
demodulation  process  will  be  described  analytically  later  in  this  chapter. 
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Finally,  the  thread  decreases  the  WaveRunner::threadsRunning  variable, 
sets  the  allChannelsDone  event  if  it  is  the  last  active  channel  thread  and  exits. 


(a)  (b) 

Figure  4-10.  (a)  Tx  thread,  (b)  Rx  thread. 


F.  DATA  ORGANIZATION 

With  the  procedures  described  so  far,  we  have  managed  to  achieve 
efficient  data  exchange  between  the  card  buffers  and  the  host  computer  memory, 
as  well  as  successful  transmission  and  reception  of  symbols.  Now  it  is  time  to 
give  meaning  to  that  data.  We  must  organize  the  data  in  such  a  way  that  the 
received  samples  must  be  meaningful  for  the  receiver.  In  other  words,  we  must 
devise  a  protocol  of  transmission  and  reception. 
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More  specifically,  there  are  two  problems  which  we  must  deal  with,  in 
order  to  achieve  meaningful  communication,  phase  synchronization  and  time 
synchronization. 

It  is  extremely  unlikely  that  the  numerical  oscillators  of  the  transmitter  and 
the  receiver  will  be  in  phase.  Almost  certainly,  they  will  have  a  random  phase 
difference.  Since  the  communication  scheme  we  have  chosen  (M-PSK)  is 
inherently  phase  coherent,  this  phase  difference  must  be  determined  and 
corrected.  Otherwise,  in  the  decoding  of  the  symbols  we  shall  always  be  off  by 
this  difference. 

Even  after  we  have  achieved  phase  synchronization,  we  have  one  more 
problem  to  solve:  since  in  the  received  signal  multiple  samples  correspond  to 
each  symbol,  which  is  the  appropriate  time  instance  or,  in  other  words,  which  of 
the  received  samples  per  symbol  is  the  most  appropriate  one  to  use  for  the 
signal  decoding?  Here  it  must  be  noted  that  unlike  the  conventional  receivers 
which  include  an  integrator,  our  receiver  consists  of  successive  downsampling 
filters.  Filters  inherently  have  memory.  That  means  that  the  first  samples  of  each 
symbol  depend  not  only  on  the  current  symbol  but  also  on  the  previous  one.  So, 
we  cannot  simply  average  the  samples.  But  even  if  we  could,  we  should  find  a 
way  to  know  where  to  start  the  integration,  that  is,  at  which  sample  each  symbol 
starts.  So,  we  need  time  synchronization. 

In  conventional  communication  systems,  the  above  tasks  are  performed 
by  dedicated  carrier  and  clock  recovery  circuits,  which  are  most  of  the  times 
sophisticated  and  contribute  to  the  overall  complexity  of  the  system.  Moreover, 
most  of  the  times  they  are  efficient  only  for  one  communication  scheme  and 
completely  inefficient  for  all  the  others.  In  our  case,  we  shall  try  to  perform  the 
above  two  tasks  solely  by  software.  Here  lies  one  of  the  greatest  beauties  of  the 
software  radio  platform,  which  illustrates  in  the  most  profound  way  how  this 
architecture  contributes  to  the  decrease  of  hardware  complexity. 
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1. 


Transmitted  Data  Organization  -  Moduiation 


The  symbols  to  be  transmitted  are  organized  in  packets  of  1024  symbols. 
Of  these  1024  symbols,  the  first  32  are  the  header  of  the  packet,  while  the  992 
remaining  symbols  constitute  the  actual  data.  Of  course,  when  transmitting  the 
data  from  a  file,  the  last  packet  will  most  likely  have  less  than  992  symbols.  This 
is  a  fact  we  have  to  take  into  consideration. 

The  composition  of  an  individual  data  packet  is  shown  at  the  table  4-5. 


Packet  Synthesis 

Symboi  Position 

Significance 

1-11 

Zero  phase 
(maximum  1,  zero  Q) 

12-24 

Barker  Code 

[11111-1-111-11-11] 

25-32 

Number  of  symbols  in  the  packet 

33-1024 

Actual  data  symbols 

Table  4-5.  Composition  of  a  transmitted  symbols  packet. 


Initially  we  transmit  11  samples  with  zero  phase.  This  can  be  achieved 
very  easily  by  feeding  the  card  with  maximum  I  and  zero  Q  samples.  In  doing  so, 
we  are  hoping  that  the  receiver  will  detect  the  constant  phase  and  then  correct  all 
the  subsequent  packet  samples  phases  accordingly. 

After  the  constant  phase  samples,  we  transmit  a  Barker  sequence  of  13 
symbols.  The  sequence  is  transmitted  in  the  I  channel,  while  the  Q  channel 
remains  zero.  This  sequence  has  excellent  autocorrelation  properties  as  shown 
in  Figure  4-11.  In  the  receiver  we  are  hoping  that  a  correlator  will  sense  the 
maximum  of  the  cross  correlation  of  the  received  signal  with  the  Barker 
sequence  and  thus  we  shall  achieve  time  synchronization. 
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The  following  8  symbols  after  the  Barker  sequence  denote  the  number  of 
symbols  per  packet.  As  we  have  already  stated,  the  number  of  symbols  per 
packet  may  vary.  So  we  need  this  information,  in  order  to  demodulate  only  the 
necessary  symbols  and  not  more.  Since  this  piece  of  information  is  one  of  the 
most  critical  parts  of  the  packet,  we  modulate  it  always  in  QPSK  regardless  of 
how  complicated  the  actual  data  modulation  may  be. 


Autocorrelation  of  the  13  bit  Barker  Sequence 
14 
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Figure  4-11.  Autocorrelation  properties  of  the  13  bit  Barker  code. 

Finally,  the  actual  data  symbols  follow,  modulated  by  the  scheme  chosen 
by  the  user.  In  our  application  we  restricted  the  possible  modulation  schemes  to 
QPSK,  8-PSK  and  16-PSK.  It  is  worth  mentioning  that  for  992  symbols  per 
packet  we  need  an  integer  number  of  bytes  for  all  three  schemes  (more 
specifically,  248  bytes  for  the  QPSK,  372  bytes  for  the  8-PSK  and  496  bytes  for 
the  16-PSK  scheme). 

We  do  not  claim  that  the  above  packet  organization  was  the  most  efficient 
that  we  could  devise.  It  was  just  a  simple  reasonable  scheme  that  we  thought 
that  would  perform  reasonably  well.  Qf  course  our  signal  would  not  be 
transmitted  in  extremely  noisy  or  distorting  environments  and  the  signal-to-noise 
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ratio  would  be  very  large.  However,  what  interested  us  for  this  thesis  was  not  to 
elaborate  on  the  details  but  rather  to  simply  prove  that  the  approach  works  and 
that  we  could  achieve  with  software  what  conventional  systems  need  dedicated 
hardware  to  achieve. 


3.  Data  Demodulation 


The  demodulation  process  is  shown  in  Figure  4-12. 


Figure  4-12.  Signal  demodulation  process. 
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The  procedure  starts  by  measuring  the  power  of  every  symbol  and 
comparing  it  to  a  threshold.  As  long  as  the  actual  data  transmission  has  not 
started  yet,  the  power  will  be  well  below  the  threshold  and  the  samples  will  be 
considered  as  noise  and  will  be  ignored. 

As  soon  as  the  symbol  power  exceeds  the  threshold,  the  phase 
synchronization  loop  is  started.  The  phase  difference  of  successive  symbols  is 
compared  against  a  threshold  and  as  long  as  it  is  below  the  threshold,  a  phase 
hit  is  declared.  When  a  predefined  number  of  hits  are  achieved  (six  in  our 
demonstration)  at  a  power  level  above  the  threshold,  we  consider  that  we  have 
detected  the  transmitted  segment  with  the  constant  phase.  The  phase  difference 
between  the  transmitter  and  the  receiver  numerical  oscillators  is  simply  the 
phase  that  we  are  measuring.  All  we  have  to  do  is  to  subtract  this  phase  from  the 
phase  of  the  subsequent  symbols  and  we  are  done.  We  have  achieved  phase 
synchronization. 

Following  the  successful  synchronization  in  phase,  we  slide  the  received 
symbols  in  a  software-implemented  correlator,  which  computes  the  cross 
correlation  between  the  received  signal  and  the  Barker  code.  The  moment  the 
cross  correlation  exceeds  a  threshold  (12  in  our  case),  we  consider  that  we  are 
positioned  in  the  beginning  of  the  Barker  code  in  the  received  signal.  So,  we 
have  achieved  time  synchronization. 

When  time  synchronization  has  been  achieved,  we  simply  advance  by  13 
symbols  and  read  the  next  8  symbols,  demodulate  them  using  a  QPSK 
demodulation  scheme  and  calculate  the  number  of  symbols  per  packet. 

What  remains  to  be  done,  is  to  successively  read  and  demodulate  the 
actual  data  symbols  of  the  packet.  After  this  task  has  been  completed,  the  whole 
procedure  is  repeated  from  the  beginning  for  each  packet,  until  the  data  file  runs 
out  of  data. 
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In  the  above  effort  to  synchronize,  we  have  used  several  thresholds:  a 
power  threshold,  a  maximum  phase  difference  threshold,  a  phase  hits  threshold 
and  a  cross  correlation  threshold.  The  choices  of  the  values  of  these  thresholds 
were  not  based  on  any  sophisticated  algorithms;  we  simply  chose  values  that 
seemed  reasonable  to  us.  However,  it  is  well  understood  that  in  a  real 
environment  where  a  large  signal-to-noise  ratio  may  not  be  achievable,  the 
setting  of  the  proper  values  for  these  thresholds  may  become  much  more 
complicated.  There  may  even  exist  instances  that  our  procedure  may  not  work  at 
all.  However,  as  we  have  already  mentioned,  at  this  stage  we  were  not  so  much 
interested  in  elaborating  the  details  but  rather  in  proving  that  our  approach  works. 
So  we  kept  the  detection  algorithm  relatively  simple. 

G.  CHOICE  OF  THE  PROPER  FILTERS 

Although  the  choice  of  the  appropriate  filters  for  the  transmitter 
interpolation  and  the  receiver  decimation  stages  may  seem  a  trivial  task  to 
perform,  it  is  actually  one  of  the  most  critical  factors  for  the  overall  performance 
of  the  system.  If  the  filters  are  chosen  inappropriately,  intersymbol  interference 
may  cause  errors  in  the  symbol  detection  even  under  large  signal-to-noise  ratios. 

For  the  needs  of  our  application,  we  chose  a  square  root  raised  cosine 
filter  for  the  transmitter  with  a  cutoff  frequency  of  tt/4,  an  interpolation  factor  of  4 
and  a  roll-off  factor  varying  from  0.25  to  0.10.  The  frequency  response  of  the  filter 
for  a  roll-off  factor  of  0.15  is  shown  in  Figure  4-13.  As  we  can  see,  the  filter  does 
not  cancel  signal  aliasing  completely  (its  stopband  does  not  start  exactly  at  tt/D), 
but  rather  permits  it  in  a  controllable  way,  so  that  it  will  be  canceled  by  the  filters 
of  the  receiver. 

In  the  receiver,  we  used  a  decimation  of  16,  performed  in  two  stages  of  4. 
At  each  stage  the  signal  was  filtered  by  a  low  pass  filter,  whose  frequency 
response  is  shown  in  Figure  4-14. 
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Frequency  Response  of  a  Square  Root  Raised  Cosine  Filter 


Figure  4-13.  Frequency  response  of  the  transmitter  shaping  filter. 


Frequency  Response  of  the  Receiver  Decimation  Filters 


Figure  4-14.  Frequency  response  of  the  receiver  decimation  filters. 
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H. 


FROM  HERE  ... 


In  the  current  chapter  we  outlined  the  main  aspects  of  our  work  and  the 
functionality  of  the  code  we  wrote.  Now  it  is  time  to  see  the  results  of  the  tests  we 
ran  with  this  code.  Did  it  really  work  and  what  results  did  we  get?  This  is  the 
subject  of  the  next  chapter. 
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V:  RESULTS  -  CONCLUSIONS 


A.  INTRODUCTION 

In  the  previous  chapter  we  described  analytically  the  application  that  we 
developed  and  the  procedures  that  are  involved  in  the  implementation  of  the 
communication  link,  both  at  the  hardware  management  level  as  well  as  at  the 
organization  of  data  in  a  meaningful  protocol. 

Now  it  is  the  time  to  see  the  results  of  this  effort.  This  chapter  will  not 
present  any  diagrams  and  curves,  because  this  was  not  the  nature  of  our  work. 
Our  result  analysis  will  consist  mainly  of  the  presentation  of  some  oscilloscope 
snapshots  in  order  to  let  the  reader  witness  what  we  saw  at  the  lab  and  an 
insight  into  the  streams  of  transmitted  and  received  data,  in  order  to  prove  and 
explain  that  our  algorithm  worked  successfully. 

B.  TEST  BENCH 

In  order  to  test  and  run  our  application,  we  set  up  a  test  bench  in  the 
microwave  lab  of  the  Spanagel  building,  as  shown  in  Figure  5-1.  The 
transceivers  were  hosted  into  two  PC-type  personal  computers  having  the 
following  features: 

•  Intel  Pentium  4  processors  at  3.05  GHz  with  multithreaded  techniology 

•  512  Mbytes  of  RAM  at  1024  MHz  (So  that  the  RAM  speed  could 
closely  follow  the  speed  of  the  processor  bus  and  would  cause  no  less 
bottlenecks). 

•  Two  SCSI  hard  disks  with  18  GBytes  capacity  each  (The  choice  of  the 
SCSI  protocol  was  imperative,  because  we  wanted  to  ensure  that  data 
transfers  between  the  computer  memory  and  the  hard  disks  would 
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occur  as  fast  as  possible  -  certainly  at  a  rate  compared  to  the  rate  of 
data  transfer  between  the  transceiver  and  the  host  computer). 


Figure  5-1 .  Test  bench  used  for  the  tests  of  the  code. 


For  each  host  computer  we  set  up  a  line  of  measuring  instruments, 
consisting  of: 

•  A  Tektronix  475  Signal  Oscilloscope 

•  A  Tektronix  492  Spectrum  Analyzer 

•  A  FIP  436A  Power  meter. 

•  A  Wavetek  148  signal  generator. 


By  the  end  of  our  experiments,  we  used  the  Tektronix  TDS  301 2B  Digital 
Oscilloscope  -  Spectrum  Analyzer,  in  order  to  capture  the  oscilloscope  images 
shown  at  the  next  paragraph. 
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c. 


OSCILLOSCOPE  IMAGES 


Figures  5-2  to  5-7  show  some  snapshots  of  the  images  of  the 
oscilloscope.  Th  upper  part  of  each  figure  (blue  curve)  is  the  signal  in  the  time 
domain,  while  the  lower  part  (red  curve)  is  the  signal  in  the  frequency  domain. 

Initially  we  generated  some  simple  tones  (signal  without  modulation).  This 
type  of  signal  can  be  presented  very  easily  at  the  oscilloscope  screen,  because  it 
is  very  easy  to  synchronize.  Especially  in  Figure  5-4,  we  demonstrate  the  ease  of 
creating  eight  tones  (one  per  transmission  channel).  At  the  same  time  eight 
recepton  channels  may  be  active  in  order  to  receive  the  signal. 

Figures  5-5  to  5-7  show  some  actual  QPSK  modulated  channels.  With  a 
careful  observation  of  the  images,  the  different  phases  of  the  signal  can  be  easily 
distinguished.  A  more  thorough  analysis  of  the  received  waveforms  will  follow  in 
the  next  paragraph. 
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Figure  5-3.  Four  tones  at  4,  8,  12  and  16  MFIz. 


Math  I  20.0  dB  5.00M'H^B-»'»-[^.0000ns  | 

Figure  5-4.  Eight  tones  at  4,8,12,16,20,24,28,32  and  36  MFIz. 
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Figure  5-5.  One  QPSK  channel  at  5  MHz. 
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Figure  5-6.  Two  QPSK  channels  at  10  and  15  MHz. 
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Figure  5-7.  Four  QPSK  channels  at  10,  15,  20  and  25  MFIz. 


D.  DATA  WAVEFORMS  ANALYSIS 


Figure  5-8  shows  the  first  100  symbols  of  a  transmitted  data  packet.  A 
careful  observation  of  the  figure  reveals  the  structure  of  the  packet.  As  we  can 
see,  the  symbols  have  a  constant  envelope,  since  they  are  BPSK  (the  Barker 
code)  or  QPSK  (the  number  of  symbols  per  packet)  modulated.  Also,  from  the 
signal  phase  diagram,  the  segments  intended  for  the  phase  synchronization  and 
the  Barker  code  segment  are  very  easily  distinguishable. 

Figure  5-9  shows  the  received  waveform  before  phase  synchronization. 
As  we  can  easily  see,  the  segment  with  the  steady  phase  is  very  easily 
recognized.  After  our  code  senses  this  phase  and  compensates  for  it,  the 
waveform  that  results  is  shown  in  Figure  5-10.  We  can  easily  see  two  things,  the 
phase  of  the  steady-phase  segment  is  now  zero  and  the  Barker  code  is  very 
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easily  distinguishable.  The  received  waveform  now  is  clearly  our  transmitted 
waveform  shaped  by  the  shaping  filters. 


Baseband  Tx  Signal 


Baseband  Tx  Signal  Amplitude 


Baseband  Tx  Signal  Phase 


Figure  5-8.  Transmitted  baseband  waveform. 

Figure  5-1 1  shows  the  cross  correlation  between  the  waveform  of  Figure 
5-10  and  the  Barker  code.  As  we  can  see,  at  the  point  of  synchronization  the 
normalized  cross-correlation  value  (cross  correlation  divided  by  the  signal  power) 
is  very  close  to  its  theoretical  maximum  of  13  (in  our  case  it  is  12.5).  Also, 
nowhere  near  this  value  does  the  cross  correlation  even  approach  this  peak.  It  is 
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very  easy  for  the  code  to  sense  this  peak  and  declare  time  synchronization  at 
this  point.  Of  course,  as  the  Figure  5-11  demonstrates,  there  may  exist  large 
cross  correlation  values  before  the  beginning  of  reception  of  the  actual  signal, 
due  to  the  random  phase  of  the  received  signal.  However,  at  that  segment  the 
received  power  is  well  below  the  threshold.  So  we  simply  ignore  these  values. 


Figure  5-9.  Received  Baseband  Signal  Waveform,  before  phase  difference 
compensation. 
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E. 


TESTS  RESULTS 


Using  the  set  up  described  in  section  B  of  this  chapter,  we  tried  all  the 
possible  modulation  schemes  for  which  the  code  was  developed,  from  simple 
test  tones  to  16-PSK  schemes. 


Received  Signal  Amplitude 


Figure  5-10.  Received  Baseband  Signal  Waveform,  after  phase  difference 
compensation. 
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At  the  transmitter  the  signal  was  fed  to  the  card  at  a  datarate  of  58,125 
symbols  per  second.  There  it  was  shaped  by  the  square  root  raised-cosine  filter 
described  at  the  previous  chapter,  interpolated  by  a  factor  of  4,  transformed  into 
analog  format  and  transmitted. 


Figure  5-11.  Cross  correlation  between  the  received  baseband  waveform  after 
phase  correction,  and  the  Barker  code. 

At  the  receiver,  the  signal  was  initially  decimated  by  the  CIC  filter  by  a 
factor  of  25.  This  decimation  rendered  a  data  throughput  of  the  CIC  filter  of  3.72 
Mbps.  Subsequently,  the  signal  was  fed  into  the  FIR  engine  of  the  DDC  and  was 
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further  decimated  by  16  in  two  stages  of  4,  using  the  shaping  LPF  described  also 
at  the  previous  chapter. 

This  procedure  gave  us  a  final  output  rate  of  232.5  ksps,  which  means  4 
samples  per  transmitted  symbol.  Taking  into  account  the  fact  that  the  null-to-null 
bandwidth  of  an  M-PSK  signal  is  twice  the  symbol  rate,  the  bandwidth  of  our 
received  signal  included  the  main  lobe  and  the  first  sidelobe  of  the  transmitted 
signal,  that  is  roughly  95%  of  the  transmitted  signal  power.  We  might  even  be 
able  to  reduce  the  output  rate  to  two  samples  per  symbol  by  further  decimating 
the  received  signal  by  a  factor  of  2,  but  that  would  need  more  carefully  designed 
shaping  filters  and  we  might  not  be  able  to  mitigate  the  intersymbol  interference 
completely.  So  we  chose  the  rate  of  4  samples  per  symbol. 

All  the  simulations  gave  very  good  results!  Phase  and  time 
synchronization  was  achieved  without  problems.  The  received  signal  was 
demodulated  and  the  transmitted  waveform  was  restored  successfully.  Even  the 
last  packet  of  the  file,  where  the  number  of  symbols  was  less  than  992  and  we 
could  not  evade  rounding  effects,  was  demodulated  without  problem.  So,  the 
above  results  confirmed  the  correctness  of  our  code. 

The  last  issue  we  have  to  mention  concerns  the  maximum  achievable 
datarate  of  the  system.  In  order  to  measure  it,  we  activated  several  channel 
combinations  from  one  Tx  channel  only  to  all  8  channel  pairs  working.  (Of 
course,  in  this  case  we  were  not  interested  in  the  correct  demodulation  of  the 
received  signal,  since  we  had  not  configured  the  channel  filters  properly.  We  only 
wanted  to  see  what  would  be  the  maximum  datarates  that  we  could  achieve). 

In  every  case,  we  achieved  a  total  datarate  between  4.2  Msps  and  5.5 
Msps  before  a  buffer  overflow  or  underflow  occurred.  This  speed  was  achieved 
using  the  32-bit  PCI  bus  of  our  host  computers.  The  transceivers  can  also 
accommodate  64-bit  transfers.  The  manufacturer  claims  that  the  maximum 
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datarate  can  reach  easily  8  Msps.  It  is  quite  possible  that  had  we  used  more 
dedicated  hosts  with  64-bit  PCI  buses,  we  would  have  achieved  these  rates. 
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VI:  FIELDS  FOR  FURTHER  STUDY 


Our  thesis  demonstrated  in  a  profound  way  some  of  the  benefits  and  the 
potentials  of  the  Software  Defined  Radio  technology.  Complicated  functionality, 
that  until  recently  required  dedicated  hardware  to  be  implemented,  can  now  be 
very  easily  implemented  solely  by  software.  The  communications  transceiver  has 
become  more  lightweight  and  generic,  while  the  software  has  given  it  the  ability 
to  adapt  to  a  variety  of  standards  and  schemes.  But  perhaps  the  most  important 
of  all  its  benefits  is  the  fact  the  cost  of  the  hardware  has  been  reduced 
dramatically.  This  fact  combined  with  the  progress  in  computer  hardware,  have 
rendered  it  possible  to  set  up  and  implement  communication  systems  at  a 
fraction  of  the  cost  we  would  need  until  recently. 

We  do  not  claim  that  with  this  thesis  we  have  exhausted  the  subject.  The 
technology  is  so  new  and  its  capabilities  are  so  enormous  that  we  only  scratched 
the  tip  of  the  iceberg.  The  possibilities  for  further  development  using  the 
hardware  we  used  in  our  thesis  are  endless.  Just  to  name  some: 

•  Connection  of  the  hardware  to  a  wireless  RF  frontend,  in  order  to 
achieve  wireless  communication. 

•  Addition  of  a  programmable  RF  frequency  upconverter  in  order  to  be 
able  to  sweep  several  frequency  bands. 

•  Addition  of  error  coding  to  our  signal  in  order  to  reduce  further  the 
probability  of  error. 

•  Study  of  the  system  performance  in  a  variety  of  noise  environments 
and  signal-to-noise  ratios. 

•  Effort  to  implement  a  known  communications  protocol  using  the 
hardware. 

•  Frequency  spectrum  measurement  and  analysis. 
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Adaptive  use  of  the  available  spectrum. 


The  last  one  of  the  above  fields  of  study  is  probably  one  of  the  most 
interesting  application  areas  of  the  software  radio  technology.  Since  the  system 
can  be  used  easily  for  both  communication  and  spectrum  measurements,  the 
communicating  parts  could  implement  a  protocol  in  order  to  analyze  the  noise 
profile  of  the  available  spectrum  and  use  it  optimally  (in  other  words  direct  their 
power  to  the  least  occupied  portions  of  the  spectrum).  In  fact,  in  another  thesis 
developed  in  parallel  with  this  one  (Ref.  10),  Captain  Nikos  Apostolou  has 
established  a  theoretical  background  on  how  this  could  be  achieved.  We  were 
hoping  to  be  able  to  implement  this  theory  in  practice  using  the  hardware,  but 
unfortunately,  due  to  time  restrictions,  we  did  not  manage  to  do  so.  This  would  be 
probably  the  most  interesting  field  of  study  for  another  student  to  continue  our 
work. 


As  a  closing  statement  of  this  text,  the  author  like  to  state  once  more  how 
exciting  the  work  on  this  thesis  was.  Despite  the  endless  hours  of  frustration  in 
the  lab,  when  nothing  seemed  to  be  working  properly,  when  the  good  results 
finally  showed  up,  our  satisfaction  was  unparalleled.  The  ability  to  control  a 
sophisticated  piece  of  hardware  using  a  common  programming  language  was 
something  that  has  always  fascinated  the  author.  Finally,  this  thesis  gave  the 
author  the  opportunity  to  apply  in  practice  a  lot  of  the  theory  he  had  learnt  in 
previous  classes,  which  was  a  very  valuable  experience  as  well. 
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APPENDIX  A:  CODE  LISTING 


Table  A-1  shows  the  files  of  the  WaveRadio  project  and  their  description 
The  listing  of  the  code  of  these  files  follows  in  the  next  pages. 


File  Name 

Description 

WaveRadio . h 

WaveRadio . cpp 

Main  application  classes  and  the  application 
initialization  code. 

MainFrm. h 

MainFrm. cpp 

ChildFrm . h 

ChildFrm . cpp 

ChildView . h 

Ch i 1 dV i e w . cpp 

Main  and  child  windows  classes  and  manipulating 
functions. 

CommsCtrlDlg . h 
CommsCtrlDlg . cpp 

The  communications  panel  main  class,  hosting  the 
three  panel  pages. 

CommsTabl . h 

CommsTabl . cpp 

CommsTab2 . h 

CommsTab2 . cpp 

CommsTabS . h 

CommsTabS . cpp 

Classes  encapsulating  the  functionality  of  the 
communication  panel  pages. 

GlobalVars . h 

Header  file  containing  global  variables  that  need  to 
be  accessed  by  all  the  files  of  the  application. 

WaveRunner . h 

WaveRunner . cpp 

Class  containing  the  functionality  of  the  one  and 
only  WaveRunner  object  of  the  application. 

WaveRunnerChannel . h 
WaveRunnerChannel . cpp 

Abstract  class,  used  as  a  building  block  for  the 
transmission  and  reception  channels. 

RxChannel . h 

RxChannel . cpp 

Class  containing  the  functionality  of  the  reception 
channels. 

TxChannel . h 

TxChannel . cpp 

Class  containing  the  functionality  of  the 
transmission  channels. 

WaveRunnerlsr . cpp 

It  contains  the  Interrupt  Service  Routine,  the 
master  Rx/Tx  thread  and  the  individual  Rx  and  Tx 
threads. 

Modemod . cpp 

Contains  the  modulation  and  demodulation 
routines. 

Memory_map . h 

Maps  the  WaveRunner  registers  addresses  to 
constants,  for  easier  use  by  the  application  files. 

Pmcradioi . h 

Contains  the  function  prototypes  of  the 
WaveRunner  library. 

Table  A-1 :  WaveRadio  project  files  description 
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The  above  listing  does  not  include  the  resource  files  of  the  project,  as  well 
as  the  library  file  pmcradio .  lib  which  contains  the  actual  code  of  the 
WaveRunner  library  functions  and  must  be  included  in  the  project,  in  order  for  the 
code  to  compile  successfully. 


WAVERADIO.H 

//  WaveRadio.h  :  main  header  file  for  the  WaveRadio  application 

// 

#pragma  once 
#ifndef  _ AFXWIN_H _ 

terror  include  'stdafx.h'  before  including  this  file  for  PCH 

tendif 

tinclude  "resource. h"  //  main  symbols 

//  CWaveRadioApp : 

//  See  WaveRadio . cpp  for  the  implementation  of  this  class 

// 

class  CWaveRadioApp  :  public  CWinApp 

{ 

public : 

CWaveRadioApp ()  ; 


/ /  Overrides 
public : 

virtual  BOOL  Init Instance () ; 
virtual  int  Exitinstance ( ) ; 

//  Implementation 
protected : 

HMENU  m_hMDIMenu; 

HACCEL  m_hMDIAccel; 


public : 

afx_msg  void  OnAppAbout () ; 
afx_msg  void  OnFileNewO; 
DECLARE_MESSAGE_MAP ( ) 

afx_msg  void  OnApplicationsCommspanel ( ) ; 

}; 


extern  CWaveRadioApp  theApp; 


WAVERADIO.CPP 

//  WaveRadio . cpp  :  Defines  the  class  behaviors  for  the  application. 

// 

tinclude  "stdafx.h" 
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#include  "WaveRadio . h" 

#include  "MainFrm.h" 

#include  "ChildFrm . h" 

#include  "CommsCtrlDlg . h" 

#ifdef  _DEBUG 
#define  new  DEBUG_NEW 
#endif 

#include  "WaveRunner . h" 

/ /  CWaveRadioApp 

BEGIN_MESSAGE_MAP (CWaveRadioApp,  CWinApp) 

ON_COMMAND ( ID_HELP_ABOUT,  OnAppAbout) 

ON_COMMAND ( ID_FILE_NEW,  OnFileNew) 

ON_COMMAND ( ID_APPLICATIONS_COMMSPANEL,  OnApplicat ionsCommspanel ) 
END_MESSAGE_MAP ( ) 


//  CWaveRadioApp  construction 

CWaveRadioApp : : CWaveRadioApp ( ) 

{ 

//  TODO:  add  construction  code  here, 

//  Place  all  significant  initialization  in  Initinstance 

} 


//  The  one  and  only  CWaveRadioApp  object 
CWaveRadioApp  theApp; 

WaveRunner*  wr=WaveRunner :  : getNewWaveRunner ( )  ; 

//  CWaveRadioApp  initialization 

BOOL  CWaveRadioApp:  : Initinstance  ( ) 

{ 

int  error=wr->Open  ( ) ; 
if  (error) 

{ 

CString  disp; 

disp . Format ( "Error :  %2d\nWaveRunner  card  could  not  be 
opened. \n  Process  will  abort error ) ; 

Af xMessageBox (disp, MB_OK, 0 ) ; 

//return  FALSE; 

} 

//  InitCommonControls ( )  is  required  on  Windows  XP  if  an 
application 

//  manifest  specifies  use  of  ComCtl32.dll  version  6  or  later  to 

enable 

//  visual  styles.  Otherwise,  any  window  creation  will  fail. 
InitCommonControls () ; 

CWinApp : : Initinstance ( ) ; 

//  Initialize  OLE  libraries 
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if  ( ! Af xOlelnit ( ) ) 

{ 

AfxMessageBox (IDP_OLE_INIT_FAILED) ; 
return  FALSE; 

} 

Af xEnableControlContainer ( )  ; 

//  Standard  initialization 

//  If  you  are  not  using  these  features  and  wish  to  reduce  the 

size 

//  of  your  final  executable,  you  should  remove  from  the  following 
//  the  specific  initialization  routines  you  do  not  need 
//  Change  the  registry  key  under  which  our  settings  are  stored 
//  TODO:  You  should  modify  this  string  to  be  something 
appropriate 

//  such  as  the  name  of  your  company  or  organization 
SetRegistryKey (_T ( "Local  AppWizard-Generated  Applications")); 

//  To  create  the  main  window,  this  code  creates  a  new  frame 

window 

//  object  and  then  sets  it  as  the  application's  main  window 

object 

CMDIFrameWnd*  pFrame  =  new  CMainFrame; 
m_pMainWnd  =  pFrame; 

//  create  main  MDI  frame  window 
if  ( ! pFrame->LoadFrame (IDR_MAINFRAME) ) 
return  FALSE; 

//  try  to  load  shared  MDI  menus  and  accelerator  table 
//TODO:  add  additional  member  variables  and  load  calls  for 
//  additional  menu  types  your  application  may  need 
HINSTANCE  hinst  =  Af xGetResourceHandle ( ) ; 
m_hMDIMenu  =  :: LoadMenu (hinst , 

MAKEINTRESOURCE ( IDR_WaveRadioTYPE ) ) ; 

m_hMDIAccel  =  :: LoadAccelerators (hinst , 

MAKEINTRESOURCE ( IDR_WaveRadioTYPE ) )  ; 

//  The  main  window  has  been  initialized,  so  show  and  update  it 
pFrame->ShowWindow (m_nCmdShow) ; 
pFrame->UpdateWindow ( )  ; 
return  TRUE; 

} 


//  CWaveRadioApp  message  handlers 

int  CWaveRadioApp:  : Exit  Instance () 

{ 

//TODO:  handle  additional  resources  you  may  have  added 
if (wr->cardStatus==0 ) 

{ 

int  error=wr->Close ( ) ; 
if  (error) 

{ 

CString  disp; 

disp . Format ( "Error :  %2d\nWaveRunner  card  could  not  be 

closed. ",  error) ; 

AfxMessageBox (disp,  MB_OK,  0 )  ; 

} 
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delete  wr; 

if  (m_hMDIMenu  !=  NULL) 

FreeResource (m_hMDIMenu) ; 
if  (m_hMDIAccel  !=  NULL) 

FreeResource (m_hMDIAccel ) ; 

return  CWinApp : : Exitinstance ( ) ; 

} 


void  CWaveRadioApp : : OnFileNew ( ) 

{ 

CMainFrame*  pFrame  =  STATIC_DOWNCAST (CMainFrame,  m_pMainWnd) ; 

//  create  a  new  MDI  child  window 
pFrame->CreateNewChild ( 

RUNTIME_CLASS (CChildFrame) ,  IDR_WaveRadioTYPE,  m_hMDIMenu, 
m_hMDIAccel ) ; 

} 


/ /  CAboutDlg  dialog  used  for  App  About 

class  CAboutDlg  :  public  CDialog 

{ 

public : 

CAboutDlg ( ) ; 

//  Dialog  Data 

enum  {  IDD  =  IDD_ABOUTBOX  } ; 
protected : 

virtual  void  DoDataExchange (CDataExchange*  pDX) ;  //  DDX/DDV 

support 

//  Implementation 
protected : 

DECLARE_MESSAGE_MAP ( ) 

}; 


CAboutDlg :: CAboutDlg ( )  :  CDialog (CAboutDlg :: IDD) 

{ 

} 


void  CAboutDlg :: DoDataExchange (CDataExchange*  pDX) 

{ 

CDialog: : DoDataExchange (pDX) ; 

} 


BEGIN_MESSAGE_MAP (CAboutDlg,  CDialog) 
END_MESSAGE_MAP ( ) 

//  App  command  to  run  the  dialog 
void  CWaveRadioApp :: OnAppAbout ( ) 

{ 

CAboutDlg  aboutDlg; 
aboutDlg . DoModal () ; 

} 
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//  CWaveRadioApp  message  handlers 


void  CWaveRadioApp: : OnApplicationsCommspanel ( ) 

{ 

//  TODO:  Add  your  command  handler  code  here 
CCommsCtrlDlg  commsCtrlDlg ( "Main  Comms  Control  Panel"); 
commsCtrlDlg . DoModal ()  ; 

} 

MAINFRM.H 

//  MainFrm.h  :  interface  of  the  CMainFrame  class 

// 


#pragma  once 

class  CMainFrame  :  public  CMDIFrameWnd 

{ 

DECLARE_DYNAMIC (CMainFrame) 
public : 

CMainFrame ( ) ; 

//  Attributes 
public : 

//  Operations 
public : 

/ /  Overrides 
public : 

virtual  BOOL  PreCreateWindow (CREATESTRUCT&  cs); 

//  Implementation 
public : 

virtual  -CMainFrame ()  ; 

#ifdef  _DEBUG 

virtual  void  AssertValid ( )  const; 
virtual  void  Dump (CDumpContextS  dc)  const; 

#endif 

protected:  //  control  bar  embedded  members 

CStatusBar  m_wndStatusBar ; 

CToolBar  m_wndToolBar ; 

//  Generated  message  map  functions 
protected : 

afx_msg  int  OnCreate (LPCREATESTRUCT  IpCreateStruct ) ; 
DECLARE_MESSAGE_MAP ( ) 

}; 

MAINFRM.CPP 

//  MainFrm.cpp  :  implementation  of  the  CMainFrame  class 
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// 


#include  "stdafx.h" 
#include  "WaveRadio . h" 

#include  "MainFrm.h" 

#ifdef  _DEBUG 
#define  new  DEBUG_NEW 
#endif 


/ /  CMainFrame 

IMPLEMENT_DYNAMIC (CMainFrame,  CMDIFrameWnd) 

BEGIN_MESSAGE_MAP (CMainFrame,  CMDIFrameWnd) 
ON_WM_CREATE ( ) 

END_MESSAGE_MAP ( ) 

static  UINT  indicators []  = 

{ 

ID_SEPARATOR,  //  status  line  indicator 

I D_I ND I CATOR_CAP  S , 

ID_INDICATOR_NUM, 

ID_INDICATOR_SCRL, 

}; 


//  CMainFrame  construction/destruction 

CMainFrame : : CMainFrame ( ) 

{ 

//  TODO:  add  member  initialization  code  here 

} 

CMainFrame : : -CMainFrame ( ) 

{ 

} 


int  CMainFrame :: OnCreate (LPCREATESTRUCT  IpCreateStruct ) 

{ 

if  (CMDIFrameWnd :: OnCreate ( IpCreateStruct )  ==  -I) 
return  -I; 

if  ( !m_wndToolBar .CreateEx (this,  TBSTYLE_FLAT,  WS_CHILD  | 
WS_VISIBLE  I  CBRS_TOP 

I  CBRS_GRIPPER  |  CBRS_TOOLTIPS  |  CBRS_FLYBY  | 
CBRS_SIZE_DYNAMIC)  | | 

! m_wndToolBar . LoadToolBar (IDR_MAINFRAME) ) 

{ 

TRACEO ( "Failed  to  create  toolbar\n"); 
return  -1;  //  fail  to  create 

} 

if  (! m_wndStatusBar . Create (this )  | | 
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! m_wndStatusBar . Setindicators (indicators, 
sizeof (indicators) /sizeof (UINT)  )  ) 

{ 

TRACEO ( "Failed  to  create  status  bar\n"); 
return  -1;  //  fail  to  create 

} 

//  TODO:  Delete  these  three  lines  if  you  don't  want  the  toolbar 
to  be  dockable 

m_wndToolBar . EnableDocking (CBRS_ALIGN_ANY) ; 

EnableDocking (CBRS_ALIGN_ANY) ; 

DockControlBar (&m_wndToolBar) ; 

return  0; 

} 

BOOL  CMainFrame : : PreCreateWindow (CREATESTRUCT&  cs) 

{ 

if (  ! CMDIFrameWnd: : PreCreateWindow (cs)  ) 
return  FALSE; 

//  TODO:  Modify  the  Window  class  or  styles  here  by  modifying 
//  the  CREATESTRUCT  cs 

return  TRUE; 

} 


//  CMainFrame  diagnostics 
#ifdef  _DEBUG 

void  CMainFrame :: AssertValid ( )  const 

{ 

CMDIFrameWnd: : AssertValid ( ) ; 

} 

void  CMainFrame :: Dump (CDumpContextS  dc)  const 

{ 

CMDIFrameWnd: :Dump(dc) ; 

} 

#endif  //_DEBUG 


//  CMainFrame  message  handlers 

CHILDFRM.H 

//  ChildFrm.h  :  interface  of  the  CChildFrame  class 

// 


#pragma  once 
#include  "ChildView . h" 

class  CChildFrame  :  public  CMDIChildWnd 

{ 

DECLARE_DYNCREATE (CChildFrame) 
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public : 

CChildFrame ( ) ; 

//  Attributes 
public : 

//  Operations 
public : 

/ /  Overrides 
public : 

virtual  BOOL  PreCreateWindow (CREATESTRUCT&  cs); 
virtual  BOOL  OnCmdMsg (UINT  nID,  int  nCode,  void*  pExtra, 
AFX_CMDHANDLERINFO*  pHandler Inf o ) ; 

//  Implementation 
public : 

//  view  for  the  client  area  of  the  frame. 

CChildView  m_wndView; 
virtual  -CChildFrame () ; 

#ifdef  _DEBUG 

virtual  void  AssertValid ( )  const; 
virtual  void  Dump (CDumpContextS  dc)  const; 

#endif 

//  Generated  message  map  functions 
protected : 

afx_msg  void  OnFileClose ( ) ; 

afx_msg  void  OnSetFocus (CWnd*  pOldWnd) ; 

afx_msg  int  OnCreate (LPCREATESTRUCT  IpCreateStruct ) ; 

DECLARE_MESSAGE_MAP ( ) 

}; 

CHILDFRM.CPP 

//  ChildFrm.cpp  :  implementation  of  the  CChildFrame  class 

// 

#include  "stdafx.h" 

#include  "WaveRadio . h" 

#include  "ChildFrm.h" 

#ifdef  _DEBUG 
#define  new  DEBUG_NEW 
#endif 


//  CChildFrame 

IMPLEMENT_DYNCREATE (CChildFrame,  CMDIChildWnd) 

BEGIN_MESSAGE_MAP (CChildFrame,  CMDIChildWnd) 
ON_COMMAND ( ID_FILE_CLOSE,  OnFileClose) 
ON_WM_SETFOCUS ( ) 

ON_WM_CREATE ( ) 

END_MESSAGE_MAP ( ) 
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//  CChildFrame  construction/destruction 


CChildFrame : : CChildFrame ( ) 

{ 

//  TODO:  add  member  initialization  code  here 

} 

CChildFrame : : ~CChildFrame ( ) 

{ 

} 


BOOL  CChildFrame: :PreCreateWindow(CREATESTRUCT&  cs) 

{ 

//  TODO:  Modify  the  Window  class  or  styles  here  by  modifying  the 
CREATESTRUCT  cs 

if (  ! CMDIChildWnd: : PreCreateWindow (cs)  ) 
return  FALSE; 

cs.dwExStyle  &=  ~WS_EX_CLIENTEDGE; 
cs.lpszClass  =  Af xRegisterWndClass ( 0  )  ; 
return  TRUE; 

} 


//  CChildFrame  diagnostics 
#ifdef  _DEBUG 

void  CChildFrame :: AssertValid ( )  const 

{ 

CMDIChildWnd: : AssertValid ( ) ; 

} 

void  CChildFrame :: Dump (CDumpContextS  dc)  const 

{ 

CMDIChildWnd: :Dump(dc) ; 

} 

#endif  //_DEBUG 


//  CChildFrame  message  handlers 
void  CChildFrame :: OnFileClose  ( ) 

{ 

//  To  close  the  frame,  just  send  a  WM_CLOSE,  which  is  the 
equivalent 

//  choosing  close  from  the  system  menu. 

SendMessage (WM_CLOSE) ; 

} 


int  CChildFrame :: OnCreate (LPCREATESTRUCT  IpCreateStruct ) 

{ 

if  (CMDIChildWnd :: OnCreate ( IpCreateStruct )  ==  -1) 
return  -1; 

//  create  a  view  to  occupy  the  client  area  of  the  frame 
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if  ( !m_wndView. Create (NULL,  NULL,  AFX_WS_DEFAULT_VIEW, 

CRect(0,  0,  0,  0),  this,  AFX_IDW_PANE_FIRST,  NULL)) 

{ 

TRACEO ( "Failed  to  create  view  window\n"); 
return  -1; 

} 

return  0; 

} 

void  CChildFrame : : OnSetFocus (CWnd*  pOldWnd) 

{ 

CMDIChildWnd : :OnSetFocus (pOldWnd) ; 
m_wndView . SetFocus ( )  ; 

} 


BOOL  CChildFrame : : OnCmdMsg (UINT  nID,  int  nCode,  void*  pExtra, 
AFX_CMDHANDLERINFO*  pHandler Inf o ) 

{ 

//  let  the  view  have  first  crack  at  the  command 
if  (m_wndView . OnCmdMsg (nID,  nCode,  pExtra,  pHandlerInfo) ) 
return  TRUE; 

//  otherwise,  do  default  handling 

return  CMDIChildWnd :: OnCmdMsg (nID,  nCode,  pExtra,  pHandlerInfo); 

} 

CHILDVIEW.H 

//  ChildView.h  :  interface  of  the  CChildView  class 

// 


#pragma  once 


//  CChildView  window 

class  CChildView  :  public  CWnd 

{ 

//  Construction 
public : 

CChildView ( ) ; 

//  Attributes 
public : 

//  Operations 
public : 

/ /  Overrides 

protected : 

virtual  BOOL  PreCreateWindow (CREATESTRUCT&  cs); 


//  Implementation 
public : 
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virtual  ~CChildView ( ) ; 


//  Generated  message  map  functions 
protected : 

afx_msg  void  OnPaint () ; 

DECLARE_MESSAGE_MAP ( ) 

}; 

CHILDVIEW.CPP 

//  ChildView . cpp  :  implementation  of  the  CChildView  class 

// 

#include  "stdafx.h" 

#include  "WaveRadio . h" 

#include  "ChildView . h" 

#ifdef  _DEBUG 
#define  new  DEBUG_NEW 
#endif 


//  CChildView 

CChildView: : CChildView ( ) 

{ 

} 

CChildView: : -CChildView ( ) 

{ 

} 


BEGIN_MESSAGE_MAP (CChildView,  CWnd) 
ON_WM_PAINT ( ) 

END_MESSAGE_MAP ( ) 


//  CChildView  message  handlers 

BOOL  CChildView: :PreCreateWindow(CREATESTRUCT&  cs) 

{ 

if  ( ! CWnd: : PreCreateWindow (cs) ) 
return  FALSE; 

cs.dwExStyle  |=  WS_EX_CLIENTEDGE; 
cs. style  &=  ~WS_BORDER; 
cs.lpszClass  = 

AfxRegisterWndClass (CS_HREDRAW | CS_VREDRAW | CS_DBLCLKS, 
: : LoadCursor (NULL,  IDC_ARROW) , 
reinterpret_cast<HBRUSH> (C0L0R_WIND0W+1 ) ,  NULL) ; 

return  TRUE; 

} 

void  CChildView :: OnPaint ( ) 
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{ 

CPaintDC  dc(this);  //  device  context  for  painting 

//  TODO:  Add  your  message  handler  code  here 

//Do  not  call  CWnd :  : OnPaint  ( )  for  painting  messages 

} 

COMMSCTRLDLG.H 

#pragma  once 

#include  "waverunner . h" 

#include  "CommsTabl . h" 

#include  "CommsTab2 . h" 

#include  "CommsTabS . h" 

//  CCommsCtrlDlg 

class  CCommsCtrlDlg  :  public  CPropertySheet 

{ 

DECLARE_DYNAMIC (CCommsCtrlDlg) 
public : 

CCommsTabl  commsTabl; 

CCommsTab2  commsTab2; 

CCommsTabS  commsTabS; 


CCommsCtrlDlg (UINT  nlDCaption,  CWnd*  pParentWnd  =  NULL,  UINT 
iSelectPage  =  0); 

CCommsCtrlDlg (LPCTSTR  pszCaption,  CWnd*  pParentWnd  =  NULL,  UINT 
ISelectPage  =  0); 

virtual  ~CCommsCtrlDlg ( ) ; 
afx_msg  void  OnCloseO; 

protected : 

DECLARE_MESSAGE_MAP ( ) 

}; 


COMMSCTRLDLG.CPP 

//  CommsCtrlDlg . cpp  :  implementation  file 

// 

#include  "stdafx.h" 

#include  "CommsCtrlDlg . h" 


//  CCommsCtrlDlg 

1MPLEMENT_DYNAM1C (CCommsCtrlDlg,  CPropertySheet) 

CCommsCtrlDlg :: CCommsCtrlDlg (UINT  nlDCaption,  CWnd*  pParentWnd,  UINT 
iSelectPage) 

: CPropertySheet (nlDCaption,  pParentWnd,  iSelectPage) 

{ 
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} 


CCommsCtrlDlg : : CCommsCtrlDlg (LPCTSTR  pszCaption,  CWnd*  pParentWnd,  UINT 
iSelectPage) 

: CPropertySheet (pszCaption,  pParentWnd,  iSelectPage) 

{ 

AddPage ( ScommsTabl )  ; 

AddPage ( &commsTab2 )  ; 

AddPage ( &commsTab3 )  ; 

for  (int  channel=0;  channel<8;  channel++) 

{ 

rxChannelInf o [ channel ] . f requency=0 ; 
rxChannelInfo [ channel ] .k=0; 
rxChannelInf o [ channel ] . datarate=0 ; 
rxChannelInfo [ channel ] . f ileName=" " ; 
txChannelInf o [channel] . frequency=0 ; 
txChannelInfo [ channel ] .k=0; 
txChannelInf o [ channel ] . datarate=0 ; 
txChannelInfo [ channel ] . f ileName=" " ; 


} 

CCommsCtrlDlg: : ~CCommsCtrlDlg ( ) 

{ 

} 

void  CCommsCtrlDlg :: OnClose ( ) 

{ 

if  (wr->rxTxEnable) 

{ 

CString  disp; 

disp="Cannot  close  panel  while  channels  are  active!"; 
Af xMessageBox (disp, MB_OK, 0 ) ; 

} 

else 

{ 

CPropertySheet : : OnClose ( ) ; 

} 

} 

BEGIN_MESSAGE_MAP (CCommsCtrlDlg,  CPropertySheet) 

END_MESSAGE_MAP ( ) 


//  CCommsCtrlDlg  message  handlers 

COMMSTAB1.H 

#pragma  once 
#include  "Resource. h" 


//  CCommsTabl  dialog 

class  CCommsTabl  :  public  CPropertyPage 

{ 
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DECLARE_DYNAMIC (CCommsTabl ) 


public : 

CCommsTabl ( ) ; 
virtual  -CCommsTabl () ; 

//  Dialog  Data 

enum  {  TDD  =  IDD_C0MMSTAB1  } ; 


protected : 

virtual  void  DoDataExchange (CDataExchange*  pDX) ;  //  DDX/DDV 

support 

DECLARE_MESSAGE_MAP ( ) 
public : 

CEdit*  configFile; 

CComboBox*  txCombo; 

CComboBox*  rxCombo; 

CButton*  rxButton; 

CButton*  txButton; 

CButton*  rxTxButton; 


bool  rxTxRunning; 


}; 


virtual 
af x_msg 
af x_msg 
af x_msg 
virtual 
af x_msg 
af x_msg 
virtual 
af x_msg 
LRESULT 


BOOL  OnInitDialog ( ) ; 

void  OnCbnSelchangeRxchannelscombo ( ) ; 
void  OnCbnSelchangeTxchannelscombo ( ) ; 
void  OnBnClickedDf gf ilef ind ( )  ; 

BOOL  OnSetActive ( ) ; 
void  OnBnClickedRxenablebutton ( ) ; 
void  OnBnClickedTxenablebutton ( )  ; 
void  OnOK ( ) ; 

void  OnBnClickedRxtxenablebutton  ( ) ; 
OnThreadsFinished (WPARAM  wparam,  LPARAM 


Iparam) ; 


COMMSTAB1.CPP 

//  CommsTabl . cpp  :  implementation  file 

// 


#include 

#include 

#include 

#include 

#include 

#include 

#include 


" stdaf X . h" 

"afxmt . h" 

"direct . h" 
"CommsCtrlDlg . h" 
"CommsTabl . h" 
"RxChannel.h" 
"TxChannel.h" 


//  CCommsTabl  dialog 

IMPLEMENT_DYNAMIC (CCommsTabl,  CPropertyPage) 
CCommsTabl : : CCommsTabl ( ) 

:  CPropertyPage (CCommsTabl :: TDD) 

{ 
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} 


CCommsTabl : : ~CCommsTabl ( ) 

{ 

} 

void  CCommsTabl :: DoDataExchange (CDataExchange*  pDX) 

{ 

CPropertyPage : : DoDataExchange (pDX) ; 

} 


BEGIN_MESSAGE_MAP (CCommsTabl,  CPropertyPage) 

ON_CBN_SELCHANGE ( IDC_RXCHANNELSCOMBO, 

OnCbnSelchangeRxchanne Is combo) 

ON_CBN_SELCHANGE ( IDC_TXCHANNELSCOMBO, 

OnCbnSelchangeTxchanne Is combo) 

ON_BN_CLICKED ( IDC_CFGFILEFIND,  OnBnClickedDf gf lief ind) 
ON_BN_CLICKED ( IDC_RXTXENABLEBUTTON,  OnBnClickedRxtxenablebutton) 
ON_MESSAGE (WM_PROCESSES_FINISHED,  OnThreadsFinished) 
END_MESSAGE_MAP ( ) 


//  CCommsTabl  message  handlers 

BOOL  CCommsTabl :: OnInitDialog ( ) 

{ 

CPropertyPage: : OnInitDialog ( ) ; 
rxTxRunning=f alse ; 

configFile  =  (CEdit*)  GetDlgltem (IDC_CFGFILE) ; 

conf igFile->SetWindowText ( "D : \ \WaveRadio\ \conf ig . wcf " ) ; 

sprintf (wr->conf IgFlle,  "conf ig . wcf " ) ; 
sprintf (wr->conf igPath,  "D : WWaveRadio" ) ; 

rxCombo  =  (CComboBox*)  GetDlgltem ( IDC_RXCHANNELSCOMBO) ; 
txCombo  =  (CComboBox*)  GetDlgltem ( IDC_TXCHANNELSCOMBO) ; 
rxTxButton  =  (CButton*)  GetDlgltem ( IDC_RXTXENABLEBUTTON) ; 
CString  str; 
for  (int  1=0;  i<9;  i++) 

{ 

str . Format (_T ( "%d" ) , 1) ; 
rxCombo->AddString (str)  ; 
txCombo->AddString (str)  ; 

} 

txChannelStatus [0] . status= (CEdit* )  GetDlgltem ( IDC_TX1STATUS ) ; 
txChannelStatus [0] .progress= (CProgressCtrl* ) 

GetDlgltem (IDC_TX1PR0GRESS) ; 

txChannelStatus [1] . status= (CEdit* )  GetDlgltem ( IDC_TX2STATUS ) ; 
txChannelStatus [ 1 ] . progress= (CProgressCtrl* ) 

GetDlgltem (IDC_TX2PROGRESS) ; 

txChannelStatus [2] . status= (CEdit* )  GetDlgltem ( IDC_TX3STATUS ) ; 
txChannelStatus [2] .progress= (CProgressCtrl*) 

GetDlgltem (IDC_TX3PROGRESS) ; 

txChannelStatus [3] . status= (CEdit* )  GetDlgltem ( IDC_TX4STATUS ) ; 
txChannelStatus [3] .progress= (CProgressCtrl*) 

GetDlgltem (IDC_TX4PROGRESS) ; 
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txChannelStatus [4] . status= (CEdit* )  GetDlgltem ( IDC_TX5STATUS ) ; 
txChannelStatus [4] .progress= (CProgressCtrl* ) 

GetDlgltem (IDC_TX5PR0GRESS) ; 

txChannelStatus [ 5 ] . status= (CEdit* )  GetDlgltem ( IDC_TX6STATUS ) ; 
txChannelStatus [5] .progress= (CProgressCtrl*) 

GetDlgltem (IDC_TX6PR0GRESS) ; 

txChannelStatus [ 6 ] . status= (CEdit* )  GetDlgltem (IDC_TX7STATUS) ; 
txChannelStatus [ 6 ] . progress= (CProgressCtrl* ) 

GetDlgltem (IDC_TX7PR0GRESS) ; 

txChannelStatus [7] . status= (CEdit* )  GetDlgltem ( IDC_TX8STATUS ) ; 
txChannelStatus [7] .progress= (CProgressCtrl*) 

GetDlgltem (IDC_TX8PR0GRESS) ; 

rxChannelStatus [0] . status= (CEdit* )  GetDlgltem ( IDC_RX1STATUS ) ; 
rxChannelStatus [0] .progress= (CProgressCtrl*) 

GetDlgltem (IDC_RX1PR0GRESS) ; 

rxChannelStatus [1] . status= (CEdit* )  GetDlgltem ( IDC_RX2STATUS ) ; 
rxChannelStatus [1] .progress= (CProgressCtrl*) 

GetDlgltem (IDC_RX2PROGRESS) ; 

rxChannelStatus [2] . status= (CEdit* )  GetDlgltem ( IDC_RX3STATUS ) ; 
rxChannelStatus [2] .progress= (CProgressCtrl*) 

GetDlgltem (IDC_RX3PROGRESS) ; 

rxChannelStatus [3] . status= (CEdit* )  GetDlgltem ( IDC_RX4STATUS ) ; 
rxChannelStatus [3] .progress= (CProgressCtrl*) 

GetDlgltem (IDC_RX4PROGRESS)  ; 

rxChannelStatus [ 4 ] . status= (CEdit* )  GetDlgltem ( IDC_RX5STATUS ) ; 
rxChannelStatus [4] .progress= (CProgressCtrl*) 

GetDlgltem (IDC_RX5PROGRESS) ; 

rxChannelStatus [5] . status= (CEdit* )  GetDlgltem ( IDC_RX6STATUS ) ; 
rxChannelStatus [5] .progress= (CProgressCtrl*) 

GetDlgltem (IDC_RX6PROGRESS) ; 

rxChannelStatus [6] . status= (CEdit* )  GetDlgltem ( IDC_RX7STATUS ) ; 
rxChannelStatus [ 6 ] . progress= (CProgressCtrl* ) 

GetDlgltem (IDC_RX7PROGRESS) ; 

rxChannelStatus [7] . status= (CEdit* )  GetDlgltem ( IDC_RX8STATUS ) ; 
rxChannelStatus [7] .progress= (CProgressCtrl*) 

GetDlgltem (IDC_RX8PROGRESS) ; 

for  (int  channel=0;  channel<8 ; channel++) 

{ 

txChannelStatus [channel] . status->SetWindowText ( "Inactive" ) ; 
txChannelStatus [channel] . progress->SetRange (0, 100) ; 
txChannelStatus [channel] . progress->SetPos (0) ; 
rxChannelStatus [channel] . status->SetWindowText ( "Inactive" ) ; 
rxChannelStatus [channel] . progress->SetRange (0, 100) ; 
rxChannelStatus [channel] . progress->SetPos (0) ; 

} 

rxCombo->SetCurSel (0)  ; 
txCombo->SetCurSel (0)  ; 

//  TODO:  Add  extra  initialization  here 

return  TRUE;  //  return  TRUE  unless  you  set  the  focus  to  a 
control 

//  EXCEPTION:  OCX  Property  Pages  should  return  FALSE 

} 


void  CCommsTabl: : OnCbnSelchangeRxchannelscombo ( ) 

{ 
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//  TODO:  Add  your  control  notification  handler  code  here 
wr->rxChannelsCount=rxCombo->GetCurSel ()  ; 
if  (wr->rxChannelsCount>0 ) 

{ 


if (wr->rxChannelsCount>wr->rxChannelsCon figured) 

{ 


>rxChannelsCount ) 


CString  disp; 

disp . Format ( "Rx  Channels  %d  -  %d  not  configured 
wr->rxChannelsConf igured+1 ,  wr- 

Af xMessageBox (disp,  MB_OK,  0 )  ; 


if  ( (wr->rxChannelsCount+wr->txChannelsCount>0 ) 

&  (wr->rxChannelsCount<=wr->rxChannelsCon figured) 

&  (wr->txChannelsCount<=wr->txChannelsConf igured) ) 

{ 

rxTxButton->EnableWindow (true)  ; 

} 

else 

{ 

rxTxButton->EnableWindow (false) ; 


void  CCommsTabl: : OnCbnSelchangeTxchannelscombo ( ) 

{ 

//  TODO:  Add  your  control  notification  handler  code  here 
wr->txChannelsCount=txCombo->GetCurSel () ; 
if  (wr->txChannelsCount>0 ) 

{ 

if (wr->txChannelsCount>wr->txChannelsCon figured) 

{ 

CString  disp; 

disp . Format ( "Tx  Channels  %d  -  %d  not  configured 
wr->txChannelsConf igured+1 ,  wr- 

>txChannelsCount )  ; 

Af xMessageBox (disp, MB_OK, 0 ) ; 

} 

} 

if  ( (wr->rxChannelsCount+wr->txChannelsCount>0 ) 

&  (wr->rxChannelsCount<=wr->rxChannelsCon figured) 

&  (wr->txChannelsCount<=wr->txChannelsConf igured) ) 

{ 

rxTxButton->EnableWindow (true)  ; 

} 

else 

{ 

rxTxButton->EnableWindow (false)  ; 

} 

} 


void  CCommsTabl: : OnBnClickedDf gf ilef ind ( ) 

{ 

//  TODO:  Add  your  control  notification  handler  code  here 


LPCSTR  f ilef ilter="WaveRunner  Configuration  filesXO  *.WCF\0  All 
filesVO 

CFileDialog  filefind(true); 

f ilef ind.m_ofn . lpstrTitle="Conf iguration  file  to  retrieve"; 
f ilef ind.m_ofn . lpstrDefExt="WCF" ; 
f ilef ind.m_ofn . lpstrFilter=filefilter; 
if  ( f ilef ind . DoModal ( ) ==IDOK) 

{ 

conf igFile->SetWindowText ( file find . GetPathName ( ) ) ; 

CString  buffer=f ilef ind . GetFileName ( ) ; 

for  (int  letter=0;  letter<buf f er . GetLength ( ) ;  letter++) 

{ 

wr->conf igFile [letter] =buffer [letter] ; 


wr->conf igFile [letter] =0 ; 

int  fileLength=buf fer . GetLength ( )  ; 

buffer=f ilef ind . GetPathName ( ) ; 

int  pathLength=buf f er . GetLength ( ) -f ileLength-1 ; 
int  pos=0; 

for  (int  letter=0;  letter<pathLength;  letter++) 

{ 

wr->conf igPath [pos] =buffer [letter]  ; 
pos++; 

if  (buffer [ letter ] ==92 ) 

{ 

wr->conf igPath [pos ] =92  ; 
pos++; 


wr->configPath[pos]=0; 


BOOL  CCommsTabl : : OnSetActive ( ) 

{ 

//  TODO:  Add  your  specialized  code  here  and/or  call  the  base 

class 

int  channelsCount ,  channelsConf igured; 

channel sCount=wr->txChannelsCount+wr->rxChannelsCount ; 
channelsConfigured=wr->txChannelsConfigured+wr- 
>rxChannelsCon figured; 

if  (channelsCount>0 ) 

{ 

if  (channelsCount> channelsConf igured) 

{ 

CString  disp; 

disp . Format ( "Some  Channels  are  not  configured."); 
Af xMessageBox (disp, MB_OK, 0 ) ; 
rxTxButton->EnableWindow (false) ; 

} 

else 

{ 

rxTxButton->EnableWindow (true ) ; 

} 

} 

else 

{ 
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rxTxButton->EnableWindow (false)  ; 

} 

return  CPropertyPage : :OnSetActive () ; 


void  CCommsTabl: : OnBnClickedRxtxenablebutton ( ) 

{ 

//  TODO:  Add  your  control  notification  handler  code  here 
if  ( ! rxTxRunning) 

{ 

rxTxButton->EnableWindow (false) ; 
txCombo->EnableWindow (false)  ; 
rxCombo->EnableWindow (false)  ; 
wr->rxTxEnable=true; 
rxTxRunning=true; 

Af xBeginThread (mainRxTxThread,  this)  ; 
rxTxButton->SetWindowText ("Stop  Rx/Tx") ; 
rxTxButton->EnableWindow (true)  ; 

} 

else 

{ 

rxTxButton->EnableWindow (false)  ; 
wr->rxTxEnable=f alse; 

for  (int  channel=0;  channel<wr->rxChannelsCount ;  channel++) 

{ 

rxBuf f erFull [ channel ] . Set Event ( ) ; 

} 

for  (int  channel=0;  channel<wr->txChannelsCount ;  channel++) 

{ 

txBuff erEmpty [ channel ] . SetEvent () ; 

} 

MSG  message; 

unsigned  short  threadsRunning=0 ; 
while (threadsRunning>0 ) 

{ 

if  ( : : PeekMessage (Smessage, NULL, 0,0, PM_REMOVE) ) 

{ 

: : TranslateMessage (Smessage) ; 

: : DispatchMessage (Smessage) ; 

} 

threadsRunning=wr->rxThreadsRunning+wr- 

>txThreadsRunning; 


txCombo->EnableWindow (true)  ; 
rxCombo->EnableWindow (true )  ; 
rxTxButton->SetWindowText ("Start  Rx/Tx") ; 
rxTxButton->EnableWindow (true )  ; 
rxTxRunning=f alse ; 


void  CCommsTabl :: OnOK ( ) 

{ 

//  TODO:  Add  your  specialized  code  here  and/or  call  the  base 

class 
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if  (rxTxRunning) 

{ 

CString  disp; 

disp . Format ( "Cannot  close  panel  while  channels  are 

active  !!!"); 

Af xMessageBox (disp, MB_OK,  0 ) ; 

} 

else 

{ 

CPropertyPage : : OnOK ( ) ; 


} 


LRESULT  CCommsTabl : : OnThreadsFinished (WPARAM  wparam,  LPARAM  Iparam) 

{ 

OnBnClickedRxtxenablebutton ( ) ; 
return  0; 

} 

COMMSTAB2.H 

#pragma  once 
#include  "Resource. h" 

//  CCommsTab2  dialog 

class  CCommsTab2  :  public  CPropertyPage 

{ 

DECLARE_DYNAMIC (CCommsTab2) 

CEdit*  rxFrequency [ 8 ] ; 

CComboBox*  rxModulation  [8]; 

CEdit*  rxSymbolRate [ 8 ]  ; 

CEdit*  rxFile[8]; 

CButton*  f IndRxFlle [ 8 ] ; 

void  SetRxChannelFileName ( short  rxChanNum) ; 
void  GetControlPointers ( )  ; 
void  InitializeControls ( ) ; 
void  EnableControls ( ) ; 

public : 

CCommsTab2  ( ) ; 
virtual  ~CCommsTab2  ( ) ; 

//  Dialog  Data 

enum  {  IDD  =  IDD_COMMSTAB2  } ; 
protected : 

virtual  void  DoDataExchange (CDataExchange*  pDX) ;  //  DDX/DDV 

support 

DECLARE_MESSAGE_MAP ( ) 
public : 


123 


}; 


virtual  BOOL 
virtual  BOOL 
afx_msg  void 
afx_msg  void 
afx_msg  void 
afx_msg  void 
afx_msg  void 
afx_msg  void 
afx_msg  void 
afx_msg  void 
virtual  BOOL 


OnInitDialog  ( ) ; 
OnSetActive ( ) ; 
OnBnClickedFindf ilel  () ; 
OnBnClickedFindf ile2 () ; 
OnBnClickedFindf ile3  () ; 
OnBnClickedFindf ile4  () ; 
OnBnClickedFindf ileS  () ; 
OnBnClickedFindf ile6 () ; 
OnBnClickedFindf ile7  () ; 
OnBnClickedFindf ileS  () ; 
OnKillActive () ; 


COMMSTAB2.CPP 

//  CommsTab2 . cpp  :  implementation  file 

// 


#include  "stdafx.h" 
#include  "CommsTab2 . h" 


//  CCommsTab2  dialog 

IMPLEMENT_DYNAMIC (CCommsTab2,  CPropertyPage) 
CCommsTab2 :  : CCommsTab2  ( ) 

:  CPropertyPage (CCommsTab2 :: IDD) 

{ 

} 

CCommsTab2 : : ~CCommsTab2 ( ) 

{ 

} 

void  CCommsTab2 : : DoDataExchange (CDataExchange*  pDX) 

{ 

CPropertyPage: : DoDataExchange (pDX) ; 

} 


BEGIN_MESSAGE_MAP (CCommsTab2,  CPropertyPage) 

ON_BN_CLICKED ( IDC_FINDFILE1 ,  OnBnClickedFindf ilel ) 
ON_BN_CLICKED ( IDC_FINDFILE2 ,  OnBnClickedFindf ile2 ) 
ON_BN_CLICKED ( IDC_FINDFILE3 ,  OnBnClickedFindf ile3 ) 
ON_BN_CLICKED ( IDC_FINDFILE4 ,  OnBnClickedFindf ile4 ) 
ON_BN_CLICKED ( IDC_FINDFILE5 ,  OnBnClickedFindf ileS ) 
ON_BN_CLICKED ( IDC_FINDFILE6 ,  OnBnClickedFindf ile6 ) 
ON_BN_CLICKED ( IDC_FINDFILE7 ,  OnBnClickedFindf ile7 ) 
ON_BN_CLICKED ( IDC_FINDFILE8 ,  OnBnClickedFindf ile8 ) 
END_MESSAGE_MAP ( ) 


//  CCommsTab2  message  handlers 
BOOL  CCommsTab2 :: OnInitDialog ( ) 
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{ 

CPropertyPage : : OnInitDialog ( ) ; 

//  TODO:  Add  extra  initialization  here 
GetControlPointers () ; 

InitializeControls () ; 

EnableControls () ; 

return  TRUE;  //  return  TRUE  unless  you  set  the  focus  to  a 
control 

//  EXCEPTION:  OCX  Property  Pages  should  return  FALSE 

} 


BOOL  CCommsTab2 : : OnSetActive ( ) 

{ 

//  TODO:  Add  your  specialized  code  here  and/or  call  the  base 

class 

EnableControls () ; 

return  CPropertyPage: : OnSetActive ( ) ; 

} 


void 

{ 


CCommsTab2 : : GetControlPointers ( ) 


rxFrequency [ 0 ]  =  (CEdit*) 
rxFrequency [ 1 ]  =  (CEdit*) 
rxFrequency [ 2 ]  =  (CEdit*) 
rxFrequency [ 3 ]  =  (CEdit*) 
rxFrequency [ 4 ]  =  (CEdit*) 
rxFrequency [ 5 ]  =  (CEdit*) 
rxFrequency [ 6 ]  =  (CEdit*) 
rxFrequency [ 7 ]  =  (CEdit*) 


GetDlgltem (IDC_FREQEDIT1) ; 
GetDlgltem (IDC_FREQEDIT2) ; 
GetDlgltem (IDC_FREQEDIT3) ; 
GetDlgltem (IDC_FREQEDIT4) ; 
GetDlgltem (IDC_FREQEDIT5) ; 
GetDlgltem (IDC_FREQEDIT6) ; 
GetDlgltem (IDC_FREQEDIT7) ; 
GetDlgltem (IDC_FREQEDIT8) ; 


rxModulation [ 0 ] 
rxModulation [ 1  ] 
rxModulation [2] 
rxModulation [3] 
rxModulation [ 4  ] 
rxModulation [5] 
rxModulation [ 6] 
rxModulation [ 7  ] 


=  (CComboBox*) 
=  (CComboBox*) 
=  (CComboBox*) 
=  (CComboBox*) 
=  (CComboBox*) 
=  (CComboBox*) 
=  (CComboBox*) 
=  (CComboBox*) 


GetDlgltem (IDC 
GetDlgltem (IDC 
GetDlgltem (IDC 
GetDlgltem (IDC 
GetDlgltem (IDC 
GetDlgltem (IDC 
GetDlgltem (IDC 
GetDlgltem (IDC 


MODULATION!)  ; 
M0DULATI0N2) ; 
MODULATION 3) ; 
MODULATION!) ; 
MODULATIONS) ; 
MODULATION 6) ; 
MODULATION!) ; 
MODULATIONS) ; 


rxSymbolRate [ 0 ] 
rxSymbolRate [ 1  ] 
rxSymbolRate [ 2 ] 
rxSymbolRate [ 3  ] 
rxSymbolRate [ 4  ] 
rxSymbolRate [ 5  ] 
rxSymbolRate [ 6  ] 
rxSymbolRate [ 7  ] 


(CEdit*) 

(CEdit*) 

(CEdit*) 

(CEdit*) 

(CEdit*) 

(CEdit*) 

(CEdit*) 

(CEdit*) 


GetDlgltem (IDC_SYMB0LRATE1) ; 
GetDlgltem (IDC_SYMB0LRATE2) ; 
GetDlgltem (IDC_SYMB0LRATE3) ; 
GetDlgltem (IDC_SYMB0LRATE4) ; 
GetDlgltem (IDC_SYMB0LRATE5) ; 
GetDlgltem (IDC_SYMB0LRATE6) ; 
GetDlgltem (IDC_SYMB0LRATE7) ; 
GetDlgltem (IDC_SYMB0LRATE8) ; 


rxFile [ 0 ] 
rxFile [ 1 ] 
rxFile [ 2 ] 
rxFile [ 3 ] 
rxFile [ 4 ] 


(CEdit*)  GetDlgltem (IDC_DESTFILE1) ; 
(CEdit*)  GetDlgltem (IDC_DESTFILE2) ; 
(CEdit*)  GetDlgltem (IDC_DESTFILE3) ; 
(CEdit*)  GetDlgltem (IDC_DESTFILE4) ; 
(CEdit*)  GetDlgltem (IDC_DESTFILE5) ; 
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rxFile[5]  =  (CEdit*)  GetDlgltem ( IDC_DESTFILE6 ) ; 
rxFile[6]  =  (CEdit*)  GetDlgltem ( IDC_DESTFILE7 ) ; 
rxFile[7]  =  (CEdit*)  GetDlgltem ( IDC_DESTFILE8 ) ; 


f indRxFile [ 0 ] 
f indRxFile [ 1 ] 
findRxFile [2] 
findRxFile [3] 
findRxFile [ 4 ] 
findRxFile [5] 
findRxFile [ 6] 
findRxFile [ 7 ] 


(CButton* ) 
(CButton* ) 
(CButton* ) 
(CButton* ) 
(CButton* ) 
(CButton* ) 
(CButton* ) 
(CButton* ) 


GetDlgltem(lDC_FlNDFlLEl) ; 
GetDlgltem (1DC_F1NDF1LE2) ; 
GetDlgltem (1DC_F1NDF1LE3) ; 
GetDlgltem (1DC_F1NDF1LE4) ; 
GetDlgltem (1DC_F1NDF1LE5) ; 
GetDlgltem (1DC_F1NDF1LE6) ; 
GetDlgltem (1DC_F1NDF1LE7) ; 
GetDlgltem(lDC_FlNDFlLE8)  ; 


} 


void 

{ 


CCommsTab2 : : InitializeControls ( ) 

CString  fileName; 
for  (int  i=0;i<8;i++) 

{ 

fileName . Format ( "D : \ \WaveRadio\ \RxChannel 
rxFile [ i ] ->SetWindowText (fileName )  ; 
rxFrequency [ i ] ->SetWindowText ("23500000") 
rxModulat ion [ i ] ->AddString ( "Test  Tone" ) ; 
rxModulat ion [ i ] ->AddString ( "QPSK"  )  ; 
rxModulat ion [ i ] ->AddString ( " 8-PSK" )  ; 
rxModulat ion [ i ] ->AddString ( " 1 6-PSK" )  ; 
rxModulation [i] ->SetCurSel (1)  ; 
rxSymbolRate [ i ] ->SetWindowText ( " 4 " )  ; 


#%lu . wdf " 


} 


void 

{ 


CCommsTab2 : : EnableControls ( ) 

for  (int  i=0;  i<wr->rxChannelsCount ;  i++) 

{ 

rxFrequency [i] ->EnableWindow (true)  ; 
rxModulation [i] ->EnableWindow (true)  ; 
rxSymbolRate [ i ] ->Enable Window (true )  ; 
rxFile [i] ->EnableWindow (true) ; 
findRxFile [i] ->EnableWindow (true)  ; 


for  (int  i=wr->rxChannelsCount ;  i<8;  i++) 

{ 

rxFrequency [i] ->EnableWindow (false) ; 
rxModulation [i] ->EnableWindow (false)  ; 
rxSymbolRate [ i ] ->Enable Window (false )  ; 
rxFile [i] ->EnableWindow (false)  ; 
findRxFile [i] ->EnableWindow (false)  ; 

} 


void  CCommsTab2 :: SetRxChannelFileName ( short  rxChanNum) 

{ 


,i+l) ; 
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LPCSTR  f ilef ilter="WaveRunner  Data  filesXO  *.WDC\0  All  filesXO 
* . *XO"; 

CFileDialog  fileflnd(false); 

f ilef ind.m_ofn . lpstrTitle="File  to  save  the  received  data"; 
f ilef ind.m_ofn . lpstrDefExt="WDC"  ; 
f ilef ind.m_ofn . lpstrFilter=filefilter; 
if  ( f ilef ind . DoModal ( ) ==IDOK) 

{ 

rxFile [ rxChanNum] ->SetWindowText ( file find . GetPathName ( ) ) ; 

} 

else 

{ 

rxFile [ rxChanNum] ->SetWindowText ( " " )  ; 

} 

} 


void  CCommsTab2 : : OnBnClickedFindf ilel ( ) 

{ 

//  TODO:  Add  your  control  notification  handler  code  here 
SetRxChannelFileName ( 0 ) ; 

} 

void  CCommsTab2 : : OnBnClickedFindf ile2 ( ) 

{ 

//  TODO:  Add  your  control  notification  handler  code  here 
SetRxChannelFileName ( 1 ) ; 

} 

void  CCommsTab2 : : OnBnClickedFindf ile3 ( ) 

{ 

//  TODO:  Add  your  control  notification  handler  code  here 
SetRxChannelFileName (2 ) ; 

} 

void  CCommsTab2 : : OnBnClickedFindf ile4 ( ) 

{ 

//  TODO:  Add  your  control  notification  handler  code  here 
SetRxChannelFileName (3) ; 

} 

void  CCommsTab2 : : OnBnClickedFindf ileS ( ) 

{ 

//  TODO:  Add  your  control  notification  handler  code  here 
SetRxChannelFileName (4)  ; 

} 

void  CCommsTab2 : : OnBnClickedFindf ile6 ( ) 

{ 

//  TODO:  Add  your  control  notification  handler  code  here 
SetRxChannelFileName ( 5 ) ; 

} 

void  CCommsTab2: : OnBnClickedFindf ile7 () 

{ 

//  TODO:  Add  your  control  notification  handler  code  here 
SetRxChannelFileName (6)  ; 
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} 


void  CCommsTab2 : : OnBnClickedFindf ile8 ( ) 

{ 

//  TODO:  Add  your  control  notification  handler  code  here 
SetRxChannelFileName ( 7 ) ; 

} 

BOOL  CCommsTab2 : : OnKillActive ( ) 

{ 

//  TODO:  Add  your  specialized  code  here  and/or  call  the  base 

class 

for  (int  rxCh=0;  rxCh<wr->rxChannelsCount ;  rxCh++) 

{ 

LPTSTR  buffer=new  char[80]; 

rxFrequency [rxCh] ->GetWindowText (buffer,  9) ; 
rxChannelInf o [rxCh] . f requency=atol (buffer) ; 
rxChannelInf o [rxCh] . k=rxModulation [rxCh] ->GetCurSel 0+1; 
rxSymbolRate [rxCh] ->GetWindowText (buffer,  9) ; 
rxChannelInf o [rxCh] . datarate=atol (buffer) ; 
rxFile [rxCh] ->GetWindowText (buffer,  80)  ; 
rxChannelInf o [rxCh] . f ileName=buf f er ; 
if  (wr->rxChannelsConf igured<wr->rxChannelsCount ) 

{ 

wr->rxChannelsConf igured=wr->rxChannelsCount ; 


} 

return  CPropertyPage : : OnKillActive ( ) ; 


COMMSTAB3.H 

#pragma  once 
#include  "Resource. h" 

//  CCommsTabS  dialog 

class  CCommsTabS  :  public  CPropertyPage 

{ 

DECLARE_DYNAMIC (CCommsTabS ) 

CEdit*  txFrequency [ 8 ] ; 

CComboBox*  txModulation [ 8 ]  ; 

CEdit*  txSymbolRate [ 8 ] ; 

CEdit*  txFile [8] ; 

CButton*  f indlxFlle [ 8 ] ; 

CComboBox*  attenuation [ 8 ] ; 

void  SetlxChannelFileName ( short  txChanNum) ; 
void  GetControlPointers ( )  ; 
void  InitializeControls ( )  ; 
void  EnableControls ( ) ; 

public : 

CCommsTabS ( ) ; 
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virtual  ~CCommsTab3 ( ) ; 


//  Dialog  Data 

enum  {  IDD  =  IDD_C0MMSTAB3  } ; 


protected : 

virtual  void  DoDataExchange (CDataExchange*  pDX) ;  //  DDX/DDV 

support 


DECLARE_MESSAGE_MAP ( ) 


public : 

virtual  BOOL 
virtual  BOOL 
afx_msg  void 
afx_msg  void 
afx_msg  void 
afx_msg  void 
afx_msg  void 
afx_msg  void 
afx_msg  void 
afx_msg  void 
virtual  BOOL 

}; 


OnInitDialog ( ) ; 
OnSetActive ( ) ; 
OnBnClickedFilef indl () ; 
OnBnClickedFilef ind2 () ; 
OnBnClickedFilef ind3 () ; 
OnBnClickedFilef ind4 () ; 
OnBnClickedFilef indS () ; 
OnBnClickedFilef ind6 () ; 
OnBnClickedFilef ind7 () ; 
OnBnClickedFilef indS () ; 
OnKillActive ( ) ; 


COMMSTAB3.CPP 

//  CommsTab3 . cpp  :  implementation  file 

// 


#include  "stdafx.h" 
#include  "CommsTab3 . h" 
#include  "math.h" 


//  CCommsTab3  dialog 

IMPLEMENT_DYNAMIC (CCommsTab3,  CPropertyPage) 
CCommsTab3 : : CCommsTab3 ( ) 

:  CPropertyPage (CCommsTab3 :: IDD) 

{ 

} 

CCommsTab3 : : ~CCommsTab3 ( ) 

{ 

} 

void  CCommsTab3 :: DoDataExchange (CDataExchange*  pDX) 

{ 

CPropertyPage: : DoDataExchange (pDX) ; 

} 


BECIN_MESSAGE_MAP (CCommsTab3,  CPropertyPage) 

ON_BN_CLICKED ( IDC_FILEFIND1 ,  OnBnClickedFilef indl ) 
ON_BN_CLICKED ( IDC_FILEFIND2 ,  OnBnClickedFilef ind2 ) 
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ON_BN_CLICKED ( IDC_FILEFIND3 , 
ON_BN_CLICKED ( IDC_FILEFIND4 , 
ON_BN_CLICKED ( IDC_FILEFIND5 , 
ON_BN_CLICKED ( IDC_FILEFIND6 , 
ON_BN_CLICKED ( IDC_FILEFIND7 , 
ON_BN_CLICKED ( IDC_FILEFIND8 , 
END_MESSAGE_MAP ( ) 


OnBnClickedFile finds ) 
OnBnClickedFilef ind4 ) 
OnBnClickedFile finds ) 
OnBnCiickedFiief ind6 ) 
OnBnCiickedFiief ind7 ) 
OnBnCiickedFiief ind8 ) 


void  CCommsTabS : : GetControiPointers ( ) 


txFrequency [ 0 ]  =  (CEdit*) 
txFrequency [ i ]  =  (CEdit*) 
txFrequency [ 2 ]  =  (CEdit*) 
txFrequency [ 3 ]  =  (CEdit*) 
txFrequency [ 4 ]  =  (CEdit*) 
txFrequency [ 5 ]  =  (CEdit*) 
txFrequency [ 6 ]  =  (CEdit*) 
txFrequency [ 7 ]  =  (CEdit*) 


GetDigItem (IDC_TXFREQUENCYi) ; 
GetDigItem (IDC_TXFREQUENCY2) ; 
GetDigItem (IDC_TXFREQUENCY3) ; 
GetDigItem (IDC_TXFREQUENCY4) ; 
GetDigItem (IDC_IXFREQUENCY5) ; 
GetDigItem (IDC_IXFREQUENCY6) ; 
GetDigItem (IDC_IXFREQUENCY7) ; 
GetDigItem (IDC_IXFREQUENCY8) ; 


txModulation [ 0 ] 
txModulation [ 1  ] 
txModulation [2] 
txModulation [3] 
txModulation [ 4  ] 
txModulation [5] 
txModulation [ 6] 
txModulation [ 7  ] 


=  (CComboBox*) 
=  (CComboBox*) 
=  (CComboBox*) 
=  (CComboBox*) 
=  (CComboBox*) 
=  (CComboBox*) 
=  (CComboBox*) 
=  (CComboBox*) 


GetDigItem (IDC 
GetDigItem (IDC 
GetDigItem (IDC 
GetDigItem (IDC 
GetDigItem (IDC 
GetDigItem (IDC 
GetDigItem (IDC 
GetDigItem (IDC 


TXMODULAIIONl)  ; 
TXMODULAIION2) ; 
TXMODULAIION3) ; 
TXMODULAIION4) ; 
TXMODULAIION5) ; 
TXMODULAIION6) ; 
TXMODULAIION7) ; 
TXMODULAIION8) ; 


txSymbolRate [ 0 ] 
txSymbolRate [ 1  ] 
txSymbolRate [ 2  ] 
txSymbolRate [ 3  ] 
txSymbolRate [ 4  ] 
txSymbolRate [ 5  ] 
txSymbolRate [ 6  ] 
txSymbolRate [ 7  ] 


(CEdit*) 

(CEdit*) 

(CEdit*) 

(CEdit*) 

(CEdit*) 

(CEdit*) 

(CEdit*) 

(CEdit*) 


GetDigItem (IDC_IXDAIARAIE1) ; 
GetDigItem (IDC_IXDAIARAIE2) ; 
GetDigItem (IDC_IXDAIARAIE3) ; 
GetDigItem (IDC_IXDAIARAIE4) ; 
GetDigItem (IDC_IXDAIARAIE5) ; 
GetDigItem (IDC_IXDAIARAIE6) ; 
GetDigItem (IDC_IXDAIARAIE7) ; 
GetDigItem (IDC_IXDAIARAIE8) ; 


txFile [ 0 ] 
txFile [ 1 ] 
txFile [ 2 ] 
txFile [ 3 ] 
txFile [ 4 ] 
txFile [ 5 ] 
txFile [ 6 ] 
txFile [ 7 ] 


(CEdit*)  GetDlgItem(IDC_IXFILEl) ; 
(CEdit*)  GetDlgItem(IDC_IXFILE2) ; 
(CEdit*)  GetDigItem (IDC_IXFILE3) ; 
(CEdit*)  GetDlgItem(IDC_IXFILE4) ; 
(CEdit*)  GetDigItem (IDC_IXFILE5) ; 
(CEdit*)  GetDigItem (IDC_IXFILE6) ; 
(CEdit*)  GetDlgItem(IDC_IXFILE7) ; 
(CEdit*)  GetDigItem (IDC_IXFILE8) ; 


f indIxFile [ 0 ] 
f indIxFile [ 1 ] 
findIxFile [2] 
findIxFile [3] 
f indIxFile [ 4 ] 
findIxFile [5] 
findIxFile [ 6] 
findIxFile [ 7 ] 


(CButton* ) 
(CButton* ) 
(CButton* ) 
(CButton* ) 
(CButton* ) 
(CButton* ) 
(CButton* ) 
(CButton* ) 


GetDigItem (IDC_FILEFIND1) ; 
GetDigItem (IDC_FILEFIND2) ; 
GetDigItem (IDC_FILEFIND3) ; 
GetDigItem (IDC_FILEFIND4) ; 
GetDigItem (IDC_FILEFIND5) ; 
GetDigItem (IDC_FILEFIND6) ; 
GetDigItem (IDC_FILEFIND7) ; 
GetDlgItem(IDC_FILEFIND8)  ; 


attenuation [ 0 ]  =  (CComboBox*)  GetDigItem ( IDC_AIIN1 ) ; 
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} 


attenuation [ 1 ] 
attenuation [ 2 ] 
attenuation [ 3 ] 
attenuation [ 4 ] 
attenuation [ 5 ] 
attenuation [ 6 ] 
attenuation [ 7 ] 


(CComboBox* ) 
(CComboBox* ) 
(CComboBox* ) 
(CComboBox* ) 
(CComboBox* ) 
(CComboBox* ) 
(CComboBox* ) 


GetDlgltem (IDC_ATTN2) ; 
GetDlgltem (IDC_ATTN3) ; 
GetDlgltem (IDC_ATTN4) ; 
GetDlgltem (IDC_ATTN5) ; 
GetDlgltem (1DC_ATTN6) ; 
GetDlgltem (1DC_ATTN7) ; 
GetDlgltem (1DC_ATTN8) ; 


void  CCommsTab3 : : InitializeControls ( ) 

{ 

CString  fileName; 
for  (int  i=0;i<8;i++) 

{ 

fileName . Format ( "TxChannel  #%li . wdf " , i+1 ) ; 
txFile [i] ->SetWindowText (fileName)  ; 
txFrequency [ i ] ->SetWindowText ("23500000")  ; 
txModulat ion [ i ] ->AddString ( "Test  Tone" ) ; 
txModulat ion [ i ] ->AddString ( "QPSK" )  ; 
txModulat ion [ i ] ->AddString ( " 8-PSK" )  ; 
txModulat ion [ i ] ->AddString ( " 1 6-PSK" )  ; 
txModulation [i] ->SetCurSel (1)  ; 
txSymbolRate [ i ] ->SetWindowText ("58125")  ; 
char  attn [ 3 ] ; 
for  (int  j=0; j<93; j=j+6) 

{ 

sprintf (attn, "%2u", j) ; 
attenuation [i] ->AddString (attn)  ; 

} 

attenuation [i] ->SetCurSel (2) ; 

} 

} 


void  CCommsTab3 : : EnableControls ( ) 

{ 

for  (int  i=0;  i<wr->txChannelsCount ;  i++) 

{ 

txFrequency [i] ->EnableWindow (true) ; 
txModulation [i] ->EnableWindow (true)  ; 
txSymbolRate [i] ->EnableWindow (true) ; 
txFile [i] ->EnableWindow (true) ; 
findTxFile [i] ->EnableWindow (true)  ; 
attenuation [i] ->EnableWindow (true)  ; 


for  (int  i=wr->txChannelsCount ;  i<8;  i++) 

{ 

txFrequency [i] ->EnableWindow (false)  ; 
txModulation [i] ->EnableWindow (false)  ; 
txSymbolRate [ i ] ->Enable Window (false )  ; 
txFile [i] ->EnableWindow (false)  ; 
findTxFile [i] ->EnableWindow (false)  ; 
attenuation [ i ] ->EnableWindow (false )  ; 

} 
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void  CCommsTabS :: SetTxChannelFileName ( short  txChanNum) 

{ 

LPCSTR  f ilef ilter="WaveRunner  Data  filesXO  *.WDF\0"; 

CFileDialog  filefind(true); 

f ilef ind.m_ofn . lpstrTitle="File  to  retrieve  the  transmission 

data" ; 

f ilef ind.m_ofn . lpstrDefExt="WDF"  ; 
f ilef ind.m_ofn . lpstrFilter=filefilter; 
if  ( f ilef ind . DoModal ( ) ==IDOK) 

{ 

txFile [txChanNum] ->SetWindowText (f ilef ind. GetPathName ( ) ) ; 

} 

else 

{ 

txFile [txChanNum] ->SetWindowText ( " " )  ; 

} 

} 

//  CCommsTabS  message  handlers 

BOOL  CCommsTabS :: OnlnitDialog ( ) 

{ 

CPropertyPage : : OnlnitDialog ( ) ; 

//  TODO:  Add  extra  initialization  here 
GetControlPointers  () ; 

InitializeControls  () ; 

EnableControls  () ; 

return  TRUE;  //  return  TRUE  unless  you  set  the  focus  to  a 
control 

//  EXCEPTION:  OCX  Property  Pages  should  return  FALSE 

} 

BOOL  CCommsTabS :: OnSetActive ( ) 

{ 

//  TODO:  Add  your  specialized  code  here  and/or  call  the  base 

class 

EnableControls () ; 

return  CPropertyPage: : OnSetActive () ; 

} 


void  CCommsTabS: : OnBnClickedFilef indl () 

{ 

//  TODO:  Add  your  control  notification  handler  code  here 
SetTxChannelFileName ( 0 )  ; 

} 

void  CCommsTabS: : OnBnClickedFilef ind2 () 

{ 

//  TODO:  Add  your  control  notification  handler  code  here 
SetTxChannelFileName ( 1 )  ; 

} 

void  CCommsTabS : : OnBnClickedFilef indS ( ) 
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{ 

//  TODO:  Add  your  control  notification  handler  code  here 
SetTxChannelFileName (2 ) ; 

} 

void  CCommsTabS : : OnBnClickedFilef ind4 () 

{ 

//  TODO:  Add  your  control  notification  handler  code  here 
SetTxChannelFileName ( 3 ) ; 

} 

void  CCommsTabS : : OnBnClickedFilef indS ( ) 

{ 

//  TODO:  Add  your  control  notification  handler  code  here 
SetTxChannelFileName ( 4 ) ; 

} 

void  CCommsTabS : : OnBnClickedFilef ind6 ( ) 

{ 

//  TODO:  Add  your  control  notification  handler  code  here 
SetTxChannelFileName (5) ; 

} 

void  CCommsTabS: : OnBnClickedFilef ind7 () 

{ 

//  TODO:  Add  your  control  notification  handler  code  here 
SetTxChannelFileName ( 6 )  ; 

} 

void  CCommsTabS: : OnBnClickedFilef indS () 

{ 

//  TODO:  Add  your  control  notification  handler  code  here 
SetTxChannelFileName ( 7 ) ; 

} 

BOOL  CCommsTabS : : OnKillActive ( ) 

{ 

//  TODO:  Add  your  specialized  code  here  and/or  call  the  base 

class 

for  (int  txCh=0;  txCh<wr->txChannelsCount ;  txCh++) 

{ 

char*  buffer=new  char[80]; 

txFrequency [txCh] ->GetWindowText (buffer,  9) ; 
txChannelInf o [txCh] . f requency=atol (buffer) ; 
txChannelInf o [txCh] . k=txModulation [txCh] ->GetCurSel ( ) +1 
txSymbolRate [txCh] ->GetWindowText (buffer,  9)  ; 
txChannelInf o [txCh] . datarate=atol (buffer) ; 
txFile [txCh] ->GetWindowText (buffer,  80) ; 
txChannelInf o [txCh] . f ileName=buf f er ; 
attenuation [txCh] ->GetWindowText (buffer,  9)  ; 
txChannelInf o [txCh] . attenuation=pow (2,  atol (buffer) /6) ; 
if  (wr->txChannelsConf igured<wr->txChannelsCount ) 


{ 

wr->txChannelsConf igured=wr->txChannelsCount ; 


} 

return  CPropertyPage : : OnKillActive ( ) ; 

} 

GLOBALVARS.H 

#include  "afxmt.h" 

#include  "WaveRunner . h" 

#define  USERISRO 
//#define  DEVICE_NUM  0 

#include  "pmcradioi . h" 

//#include  "pmcradio_memmap . h" 

#ifndef  TYPES_DEFINED 

#define  TYPES_DEFINED 

#define  WM_PROCESSES_FINISHED  WM_USER  +  1 

const  float  pi=3 . 1415926535; 

struct  ChannelStatus 

{ 

CEdit*  status; 

CProgressCtrl*  progress; 

}; 


struct  ChannelInfo{ 

unsigned  long  frequency; 
unsigned  short  k; 
unsigned  int  datarate; 

CString  fileName; 

unsigned  short  attenuation; 

bool  FIFOInterruptMask; 

unsigned  short  FIFOInterruptStatus ; 


#endif 

//The  one  and  only  object  of  the  WaveRunner  card 
extern  WaveRunner*  wr; 

//Global  Arrays  storing  the  channel  data  and  status 
extern  ChannelStatus  txChannelStatus [ 8 ] ; 
extern  ChannelStatus  rxChannelStatus [ 8 ] ; 
extern  Channelinfo  txChannelInf o [ 8 ] ; 
extern  Channelinfo  rxChannelInf o [ 8 ] ; 

//The  main  and  the  Rx/Tx  threads 

extern  UINT  mainRxTxThread (LPVOID  pParam) ; 

extern  UINT  rxThread (LPVOID  pParam) ; 

extern  UINT  txThread (LPVOID  pParam); 

extern  CString  Modulate (int  txChannelNumber) ; 
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extern  void  Demodulate ( int  rxChannelNumber ,  bool  createLog) ; 

extern  CEvent  txBuf f erEmpty [ WaveRunner : : maxChannels ] ; 
extern  CEvent  rxBufferFull [WaveRunner :: maxChannels ] ; 


WAVERUNNER.H 

#pragma  once 
#include  "RxChannel . h" 

#include  "TxChannel . h" 

//Static  variable  defining  if  the  WaveRunner 
//Singleton  class  has  been  initiated 

class  WaveRunner 

{ 

private : 

WaveRunner (void) ; 

void  InitVariables (void) ; 


public : 

//The  maximum  number  of  channels 

const  static  unsigned  short  maxChannels=8 ; 

/ /  The  number  of  32  bit  samples  per  block 
const  static  unsigned  short  blockSize=1024 ; 
const  static  unsigned  long  rxClockFrequency=93000000 ; 
const  static  unsigned  long  txClockFrequency=93000000 ; 


unsigned  long*  f irmwareRevisionDate ; 

char  conf igPath [ 80 ] ; 

char  conf igFile [ 80 ] ; 

int  cardStatus; 

bool  configured; 


//  DMA  addresses 
unsigned  long  IDMAvAddress ; 
unsigned  long*  DMA_virtual_Address ; 
unsigned  long  IDMApAddress ; 
unsigned  long*  DMA_physical_Address ; 
unsigned  long  txControl; 
unsigned  long  rxControl; 
unsigned  long  interruptMask; 
unsigned  long  autoDMACtrl; 
unsigned  long  txFIFOmask; 
unsigned  long  rxFIFOmask; 


//Threads  status 
unsigned  int  threadsReady; 
unsigned  short  rxThreadsRunning; 
unsigned  short  txThreadsRunning; 


//  Status  variables 
bool  rxTxEnable; 


//Channel  Pointers 
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RxChannel*  rxChannel [ 8 ] ; 
TxChannel*  txChannel [ 8 ] ; 


/ / Channel 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 

unsigned 


Parameters 

long  rxBlocksPerGroup; 
long  rxGroupsPerChannel ; 
long  rxThresholdGroups ; 
long  rxChannelSize ; 
long  txBlocksPerGroup; 
long  txGroupsPerChannel ; 
long  txThresholdGroups ; 
long  txChannelSize; 
long  memorySize; 


unsigned 


long  maxAmplitude; 


//Channels  status 
unsigned  short  txChannelsCount ; 
unsigned  short  rxChannelsCount ; 
unsigned  short  rxChannelsConf igured; 
unsigned  short  txChannelsConf igured; 

static  WaveRunner*  getNewWaveRunner ( ) ; 

int  Open  ( ) ; 

int  Close  ( ) ; 

int  Configure  0; 

int  enableTx (void) ; 

int  disableTx (void)  ; 

int  enableRx (void) ; 

int  disableRx (void)  ; 

int  enableRxTx ( ) ; 

int  disableRxTx ( ) ; 

int  enableinterrupts ( )  ; 

int  disableinterrupts ( )  ; 

~WaveRunner (void)  ; 


WAVERUNNER.CPP 


#include 

#include 

#include 

#include 

#include 

#include 

#include 


"StdAfx.h" 
"direct . h" 
"math . h" 
"WaveRunner . h" 
"RxChannel. h" 
"TxChannel . h" 
"memory_map . h" 


//Variable  declaring  if  a  WaveRunner  object 

//has  already  been  created 

bool  bWaveRunnerAlreadyCreated=f alse; 


//Class  constructor 
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WaveRunner: : WaveRunner (void) 

{ 

configFile[0]=0; 
conf igPath [ 0 ] =0 ; 
cardStatus=-l ; 
conf igured=f alse ; 

rxTxEnable=f alse ; 
txChannelsCount=0 ; 
rxChannelsCount=0 ; 
txChannelsConf igured=0 ; 
rxChannelsConf igured=0 ; 

DMA_v i r t  u  a l_Addr e  s  s = & 1 DMA vAddr e  s  s ; 
DMA_physical_Address=&lDMApAddress ; 

maxAmplitude=0x7FFF ; 

InitVariables () ; 

} 


//Class  destructor 
WaveRunner : : -WaveRunner (void) 
{ 

} 


void  WaveRunner :: InitVariables ( ) 

{ 

threadsReady=0 ; 
rxThreadsRunning=0 ; 
txThreadsRunning=0 ; 

} 


//Singleton  Class  Instantiation 
WaveRunner*  WaveRunner: : getNewWaveRunner ( ) 

{ 

if  ( ! bWaveRunnerAlreadyCreated) 

{ 

bWaveRunnerAlreadyCreated=true ; 
return  new  WaveRunner () ; 

} 

else 

{ 

return  NULL; 

} 

} 


Int  WaveRunner :: Open ( ) 

{ 

InitVariables () ; 
rxBlocksPerGroup=4 ; 
rxGroupsPerChannel=2 ; 
rxThresholdGroups=l ; 

rxChannelSize=blockSize*rxBlocksPerGroup*rxGroupsPerChannel ; 
txBlocksPerGroup=4 ; 
txGroupsPerChannel=2 ; 
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txThresholdGroups=l ; 

txChannelSize=blockSize*txBlocksPerGroup*txGroupsPerChannel ; 
//Reset  the  DUG 

WriteWaveRunner (OxlOlFC,  0x2); 

WriteWaveRunner (OxlOSFC,  0x2); 

SetDMABufferSize (512)  ; 
cardStatus=OpenMultiWaveRunner (0)  ; 
if  (  ! cardStatus) 

{ 

//Disable  Discrete  output 

WriteWaveRunner (_DISCRETE_OUTPUT_CONTROL,  0x0) ; 

//Write  0  to  DMA  control  register  to  make  sure  it's  off 
WriteWaveRunner (_AUTO_DMA_CONTROL,  0x0)  ; 

//Make  sure  all  interrupts  are  disabled 
WriteWaveRunner (_GLOBAL_INTERRUPT_MASK, 
_DISABLE_INTERRUPTS) ; 

WriteWaveRunner (_INTERRUPT_MASK,  0x0) ; 

//Get  memory  map  pointers  and  set  channels  memory  pointers 
GetDMAPA (&lDMApAddress,  SlDMAvAddress) ; 
unsigned  long  totalMemory=GetMaxDMABuf f erSize ( ) ; 
for  (int  channel=0;  channel<maxChannels ;  channel++) 

{ 

rxChannel [channel] =new  RxChannel (channel) ; 
rxBuf f erFull [ channel ] . Re set Event ( ) ; 
rxChannel [channel] ->dataBuf f er= 

(unsigned 

long*)  (lDMAvAddress  +  4*rxChannelSize*channel)  ; 

for  (int  symbol=0;  symbol<rxChannelSize;  symbol++) 

* (rxChannel [channel] ->dataBuf f er+symbol ) =0 ; 

} 

for  (int  channel=0;  channel<maxChannels ;  channel++) 

{ 

txChannel [channel] =new  TxChannel (channel) ; 
txBuff erEmpty [ channel ] .ResetEvent () ; 
txChannel [channel] ->dataBuf f er= 

(unsigned 

long* ) ( lDMAvAddress+4*rxChannelSize*maxChannels+ 
4*txChannelSize*channel) ; 

for  (int  symbol=0;  symbol<rxChannelSize;  symbol++) 

* (txChannel [ channel ] ->dataBuff er+symbol ) =0 ; 

} 

conf igured=f alse ; 

} 

return  cardStatus; 

} 


int  WaveRunner :: Close  ( ) 

{ 

if  ( ! cardStatus) 

{ 

//Make  sure  all  interrupts  are  disabled 
WriteWaveRunner (_GLOBAL_INTERRUPT_MASK, 
_DISABLE_INTERRUPTS) ; 
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//Make  sure  that  Tx  and  Rx  are  disabled 
disableRxTx ( ) ; 

//Reset  the  DUC 

WriteWaveRunner (OxlOlFC,  0x1); 

for  (int  channel=0;  channel<maxChannels ;  channel++) 

{ 

delete  txChannel [ channel ] ; 

} 

for  (int  channel=0;  channel<maxChannels ;  channel++) 

{ 

delete  rxChannel [ channel ] ; 

} 

//Close  card 
conf igured=f alse ; 
cardStatus=-l ; 

return  CloseMultiWaveRunner ( 0 ) ; 


} 


else 

{ 

return  -2; 

} 


//Configuration  subroutine 
int  WaveRunner : : Conf igure ( ) 

{ 

unsigned  long  writeData=0x0 ; 

if  ( (rxChannelsCount==0 )  &  (txChannelsCount==0 ) ) 

{ 

Af xMessageBox ( "No  Tx/Rx  channels  specified",  MB_OK, 0); 
return  -4; 

} 

if  (conf igFile==NULL) 

{ 

Af xMessageBox ( "No  configuration  file  specified",  MB_OK,0); 
return  -5; 

} 

//Configure  the  Up  and  Downconverters ,  using  the  files  produced 
//by  the  Configuration  Tool 
_chdir (configPath)  ; 

int  ioError=Conf igWaveRunner (conf igFile)  ; 
if  (ioError) 

{ 

Af xMessageBox ( "Unable  to  configure  WaveRunner",  MB_OK,0); 
return  ioError; 

} 

//Read  Tx  and  Rx  status 

ReadWaveRunner (_TRANSMIT_CONTROL,  &txControl) ; 
txControl=txControl  &  OxFFFFFFSF; 

ReadWaveRunner (_RECEIVE_CONTROL,  &rxControl) ; 
rxControl=rxControl  &  OxFFFFFFSF; 

ReadWaveRunner (_INTERRUPT_MASK,  SinterruptMask) ; 
interruptMask=interruptMask  &  OxFFFOOOOO; 

ReadWaveRunner (_AUTO_DMA_CONTROL,  SautoDMACtrl ) ; 
autoDMACtrl=autoDMACtrl  &  OxfffffcOf; 
txFIFOmask=0 ; 
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rxFIFOmask=0 ; 

//Make  sure  that  Tx  and  Rx  are  disabled 
WriteWaveRunner (_TRANSMIT_CONTROL,  0x0) ; 
WriteWaveRunner (_RECEIVE_CONTROL, 0x0) ; 
WriteWaveRunner (_INTERRUPT_MASK,  0x0)  ; 


//*********  Receiver  Configuration 


■k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 


//Write  the  Rx  DMA  Control  Register  in  the  PCI  configuration 
//address  space 
char  PCIConf ig [ 4 ] ; 

PCIConfig[0]=0x7E; 

PCIConf ig [ 1 ] =char ( (blockSize/2 )  &  OxFF) ; 

PCIConf ig [ 2 ] =char (( (blockSize/2 )  &  0xFF00)>>8); 

PCIConf ig [ 3 ] =char (( (blockSize/2 )  &  OxFFOOOO) >>16) ; 

WriteWRConf igSpace ( 0x4C,  PCIConfig,  4); 

//For  every  Rx  channel 

for  (int  rxCh=0;  rxCh<maxChannels ;  rxCh++) 

{ 

//Write  the  Auto  DMA  Address  registers 

unsigned  long  rxAddress=lDMApAddress+4*rxChannelSize*rxCh; 
WriteWaveRunner (_RX_MEMORY_AREA_0_ADDRESS+0xl0*rxCh, 


rxAddress ) ; 

//Write  Auto  DMA  block  count  register 

WriteWaveRunner (_RX_MEMORY_AREA_0_BLOCK_COUNT+OxlO*rxCh, 
rxBlocksPerGroup) ; 

//Write  the  Auto  DMA  Group  Count  Registers 
WriteWaveRunner (_RX_MEMORY_AREA_0_GROUP_COUNT+OxlO*rxCh, 
rxGroupsPerChannel ) ; 

//Write  the  memory  area  sizes 


writeData= (rxChannelSize*rxThresholdGroups/ (2*rxGroupsPerChannel ) 

)  I 


writeData) ; 


writeData) ; 


writeData) ; 


( (rxChannelSize/2 ) <<16) ; 

WriteWaveRunner (_RX_MEMORY_AREA_0_LIMITS+0xl0*rxCh, 
//Write  the  memory  area  limits 

unsigned  long  startOf f set=rxCh*rxChannelSize/2 ; 
unsigned  long  endOf f set= (rxCh+1 ) *rxChannelSize/2-l ; 
writeData=startOf f set  |  (endOf f set<<l 6 ) ; 

WriteWaveRunner (_RX_MEMORY_AREA_0_POINTER+0xl0*rxCh, 

//Write  the  memory  organization  control  register 
unsigned  short  channelMask= ( l<<rxCh) ; 
writeData= (rxCh<<12 ) | (rxCh<<8) ; 
if  (rxCh<rxChannelsCount ) 

writeData=writeData  |  channelMask; 

WriteWaveRunner (_RX_MEMORY_AREA_0_ORGANIZATION+OxlO*rxCh, 

//Mofdify  the  Interrupt  Mask 
if  (rxCh<rxChannelsCount ) 

{ 

interruptMask=interruptMask  |  (0x1  <<  (4+rxCh)); 

rxFIFOmask=rxFIFOmask  |  (OxB  <<  (4*rxCh)); 

} 
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//Write  Rx  FIFO  Interrupt  Mask 

WriteWaveRunner (_RECEIVE_FIFO_INTERRUPT_MASK,  rxFIFOmask) ; 

//Flush  Rx  FIFOs 

WriteWaveRunner (_RECEIVE_CONTROL,  rxControl  |  _FIFO_FLUSH) ; 
WriteWaveRunner (_RECEIVE_CONTROL,  rxControl  &  _TX_FIFO_ENABLE) ; 
//Configure  Receiver  to  8X1  channels 
writeData=rxControl  |  _BIT_REGISTERS_ENABLE  | 

_RX_MASTER_ENABLE  |  _RX_CIRCUITRY_ENABLE; 
if  (rxChannelsCount>0 )  writeData=writeData  |  ( (rxChannelsCount- 

1)«4)  ; 

WriteWaveRunner (_RECEIVE_CONTROL,  writeData)  ; 

//Disable  Timing  Control 

WriteWaveRunner (_RECEIVE_TIMING_CONTROL,  0x0) ; 

//Set  Receive  clock  frequency 

//WriteWaveRunner (0x001128,  clockFrequency-2 ) ; 

//***************  Transmiter  Configuration  ********************* 

//Write  the  Tx  DMA  Control  Register  in  the  PCI  configuration 
address  space 

PCIConfig [0] =0x6E; 

PCIConf ig [ 1 ] =char ( (blockSize/2 )  &  OxFF) ; 

PCIConfig [ 2 ] =char (( (blockSize/2 )  &  0xFF00)>>8); 

PCIConf ig [ 3 ] =char (( (blockSize/2 )  &  OxFFOOOO) >>16) ; 

WriteWRConf igSpace ( 0x54 ,  PCIConfig,  4); 
for  (int  txCh=0;  txCh<maxChannels ;  txCh++) 

{ 

//Write  the  Auto  DMA  Address  registers 

writeData=lDMApAddress+4* (rxChannelSize*maxChannels+txChannelSize 
*txCh) ; 

WriteWaveRunner (_TX_MEMORY_AREA_0_ADDRESS+0xl0*txCh, 

writeData) ; 

//Write  Auto  DMA  block  count  register 

WriteWaveRunner (_TX_MEMORY_AREA_0_BLOCK_COUNT+OxlO*txCh, 
txBlocksPerGroup) ; 

//Write  the  Auto  DMA  Group  Count  Registers 

WriteWaveRunner (_TX_MEMORY_AREA_0_GROUP_COUNT+OxlO*txCh, 
txGroupsPerChannel )  ; 

//Write  the  memory  area  sizes 

writeData= (blocks ize*txBlocksPerGroup*txThresholdGroups/ 2 ) 

I  ( (txChannelSize/2 ) <<1 6 )  ; 

WriteWaveRunner (_TX_MEMORY_AREA_0_LIMITS+0xl0*txCh, 

writeData) ; 

//Write  the  memory  area  limits 

unsigned  long  startOf f set=txCh*txChannelSize/2 ; 
unsigned  long  endOf f set= (txCh+1 ) *txChannelSize/2-l ; 
writeData=startOf f set  |  (endOf f set<<l 6 ) ; 

WriteWaveRunner (_TX_MEMORY_AREA_0_POINTER+0xl0*txCh, 

writeData) ; 

//Write  the  memory  organization  control  register 
writeData= (txCh<<12 ) | (txCh<<8) ; 
if  (txCh<txChannelsCount ) 

writeData=writeData  |  (l<<txCh); 

WriteWaveRunner (_TX_MEMORY_AREA_0_ORGANIZATION+OxlO*txCh, 

writeData) ; 
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//Write  the  FIFO  interrupt  Mask 

WriteWaveRunner (_TRANSMIT_FIFO_INTERRUPT_MASK,  0) ; 
//Write  the  Interrupt  Mask  register 
if  (txCh<txChannelsCount ) 

{ 

interruptMask=interruptMask  |  (Oxl  <<  (I2+txCh)); 
txFIFOmask=txFIFOmask  |  (OxB  <<  (4*txCh)); 

} 


} 

/ /Write  Tx  FIFO  interrupt  mask 

WriteWaveRunner (_TRANSMIT_FIFO_INTERRUPT_MASK, 

//Flush  device  FIFOs; 

ReadWaveRunner (_TRANSMIT_CONTROL,  &writeData) ; 

WriteWaveRunner (_TRANSMIT_CONTROL,  writeData  | 

WriteWaveRunner (_TRANSMIT_CONTROL,  writeData  & 

//Configure  Transmitter  to  8X1  channels 
writeData=txControl  |  _TX_BIT_REGISTERS_ENABLE 

_TX_MASTER_ENABLE  |  _TX_MASTER_SYNC_ENABLE  | 
_TX_CIRCUITRY_ENABLE; 

if  (txChannelsCount>0 )  writeData=writeData  |  ( (txChannelsCount- 


txFIFOmask) ; 


_TX_FIFO_FLUSH) ; 
_TX_FIFO_ENABLE) 


I 


1)«4)  ; 

WriteWaveRunner (_TRANSMIT_CONTROL,  writeData) ; 
//Disable  Timing  Control 

WriteWaveRunner (_TX_TIMING_CONTROL,  0x0) ; 

//Set  Transmit  Clock  Rate 

//WriteWaveRunner (0x002128,  clockFrequency-2 ) ; 
//Disable  the  PRN  function 
//WriteWaveRunner (_PRN_CONTROL,  OxlA) ; 
//WriteWaveRunner (_PRN_ZERO_IQ_VALUE,  0x0) ; 
//WriteWaveRunner (_PRN_ONE_IQ_VALUE,  0x0) ; 


/ /Write  interrupt  mask 

WriteWaveRunner (_INTERRUPT_MASK,  interruptMask) ; 

//Write  Auto  DMA  control 
writeData= ( (blockSize/2 ) <<16) ; 

if  (txChannelsCount>0 )  writeData=writeData  |  ( (txChannelsCount- 

1)«7)  ; 

if  (rxChannelsCount>0 )  writeData=writeData  |  ( (rxChannelsCount- 

1)«4)  ; 

writeData=writeData  |  _AUTO_COUNTERS_RELOAD; 

WriteWaveRunner (_AUTO_DMA_CONTROL,  writeData) ; 

//Perform  dummy  reads  in  order  to  clear  status 
unsigned  long  Dummy; 

ReadWaveRunner (_RECEIVE_FIFO_INTERRUPT_STATUS,  &Dummy) ; 
ReadWaveRunner (_TRANSMIT_FIFO_INTERRUPT_STATUS,  SDummy) ; 
ReadWaveRunner (_INTERRUPT_MASK,  &Dummy) ; 
conf igured=true; 
return  0; 

} 


int 

{ 


WaveRunner: : enableTx (void) 

if  (configured) 

{ 

unsigned  long  readData; 

//Set  Auto  DMA  Control  Register 


ReadWaveRunner (_AUTO_DMA_CONTROL,  SreadData)  ; 
WriteWaveRunner (_AUTO_DMA_CONTROL,  readData  | 
_TX_AUTO_DMA_ENABLE) ; 

//Set  Interrupt  Mask  Register 
ReadWaveRunner (_INTERRUPT_MASK,  SreadData) ; 
readData=readData  |  _DMA_ABORT_DETECTED_ENABLE  | 
_TX_DMA_COMPLETE_ENABLE  | 
_TX_FIFO_INTERRUPT_ENABLE ; 

WriteWaveRunner (_INTERRUPT_MASK,  readData) ; 

//Enable  Interrupts 

WriteWaveRunner (_GLOBAL_INTERRUPT_MASK, 

_ENABLE_INTERRUPTS)  ; 

//Set  Tx  Control  Register 

ReadWaveRunner (_TRANSMIT_CONTROL,  SreadData) ; 
WriteWaveRunner (_TRANSMIT_CONTROL,  readData  |  _TX_ENABLE) ; 
//Send  master  sync  to  DUC 
for  (int  i=0;  i<500;  i++) ; 

WriteWaveRunner (0x2130, 0x1) ; 
return  0; 

} 

else 

{ 

return  -4; 

} 

} 


int  WaveRunner : : disableTx (void) 

{ 

if  (configured) 

{ 

//Disable  interrupts 

WriteWaveRunner (_GLOBAL_INTERRUPT_MASK, 

_DISABLE_INTERRUPTS)  ; 

//WriteWaveRunner (_TRANSMIT_FIFO_INTERRUPT_MASK, 
_DISABLE_INTERRUPTS) ; 

unsigned  long  readData; 

ReadWaveRunner (_INTERRUPT_MASK,  SreadData) ; 

WriteWaveRunner (_INTERRUPT_MASK,  readData  & 
_TX_INTERRUPTS_DISABLE) ; 

/ /Disable  DMA 

ReadWaveRunner (_AUTO_DMA_CONTROL,  SreadData) ; 
WriteWaveRunner (_AUTO_DMA_CONTROL,  readData  & 
_TX_AUTO_DMA_DISABLE) ; 

//Disable  Receiver  circuitry 

ReadWaveRunner (_TRANSMIT_CONTROL,  SreadData) ; 
WriteWaveRunner (_TRANSMIT_CONTROL,  readData  &  _TX_DISABLE) ; 
//Reset  the  DUC 

WriteWaveRunner (OxlOlFC,  0x2); 

WriteWaveRunner (0xl03FC,  0x2); 
return  0; 

} 

else 

{ 

return  -4; 

} 

} 
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int  WaveRunner : : enableRx (void) 


if  (configured) 

{ 


unsigned  long  readData; 

//Set  Auto  DMA  Control  Register 
ReadWaveRunner (_AUTO_DMA_CONTROL,  SreadData)  ; 
WriteWaveRunner (_AUTO_DMA_CONTROL,  readData  | 
_RX_AUTO_DMA_ENABLE) ; 

//Set  Interrupt  Mask  Register 
ReadWaveRunner (_INTERRUPT_MASK,  SreadData)  ; 
WriteWaveRunner (_INTERRUPT_MASK,  readData  | 
_RX_DMA_COMPLETE_ENABLE) ; 

//Enable  Interrupts 

WriteWaveRunner (_GLOBAL_INTERRUPT_MASK, 
_ENABLE_INTERRUPTS) ; 

//Set  Receive  Control  register 
ReadWaveRunner (_RECEIVE_CONTROL,  SreadData) ; 
WriteWaveRunner (_RECEIVE_CONTROL,  readData  |  _RX_ENABLE) ; 
return  0; 

} 

else 

{ 

return  -4; 

} 

} 


int  WaveRunner :: disableRx (void) 

{ 

if  (configured) 

{ 

//Disable  Interrupts 

WriteWaveRunner (_GLOBAL_INTERRUPT_MASK, 
_DISABLE_INTERRUPTS) ; 

/ /WriteWaveRunner (_RECEIVE_FIFO_INTERRUPT_MASK, 
_DISABLE_INTERRUPTS) ; 

unsigned  long  readData; 

ReadWaveRunner (_INTERRUPT_MASK,  SreadData) ; 

WriteWaveRunner (_INTERRUPT_MASK,  readData  & 
_RX_INTERRUPTS_DISABLE) ; 

//Disabe  DMA 

ReadWaveRunner (_AUTO_DMA_CONTROL,  SreadData) ; 
WriteWaveRunner (_AUTO_DMA_CONTROL,  readData  & 
_RX_AUTO_DMA_DISABLE) ; 

//Disable  Receiver  circuitr 

ReadWaveRunner (_RECEIVE_CONTROL,  SreadData) ; 
WriteWaveRunner (_RECEIVE_CONTROL,  readData  &  _RX_DISABLE) ; 
return  0; 

} 

else 

{ 

return  -4; 

} 

} 
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int  WaveRunner : : enableRxTx ( ) 

{ 

if  (configured) 

{ 

if  (rxChannelsCount>0 )  enableRxO; 
for  (int  i=0;  i<5000;i++); 
if  (txChannelsCount>0 )  enableTxO; 
return  0; 

} 

else 

{ 

return  -4; 

} 

} 


int  WaveRunner :: disableRxTx ( ) 

{ 

if  (configured) 

{ 

disableinterrupts () ; 
if  (rxChannelsCount>0 )  disableRxO; 
if  (txChannelsCount>0 )  disableTxO; 
return  0; 

} 

else 

{ 

return  -4; 

} 

} 


int  WaveRunner: : enableinterrupts () 

{ 

if  (configured) 

{ 

WriteWaveRunner (_GLOBAL_INTERRUPT_MASK, 
_ENABLE_INTERRUPTS) ; 

return  0; 

} 

else 

{ 

return  -4; 


int  WaveRunner: : disableinterrupts () 

{ 

if  (configured) 

{ 

WriteWaveRunner (_GLOBAL_INTERRUPT_MASK, 
_DISABLE_INTERRUPTS)  ; 

return  0; 

} 


else 
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{ 


return  -4; 


} 

} 

WAVERUNNERCHANNEL.H 

#pragma  once 

class  WaveRunnerChannel 

{ 

public : 

unsigned  short  channelNumber ; 
unsigned  short  channelOf f set ; 
unsigned  long  frequency; 
unsigned  short  k; 

CString  dataFileName; 

unsigned  long  dataRate; 
unsigned  long  of f setAddress ; 
unsigned  long*  dataBuffer; 
unsigned  int  groupsTransf ered; 
unsigned  short  groupCount; 
//bool  bufferReady; 

bool  terminateProcess ; 
bool  threadRunning; 
bool  threadReady; 

WaveRunnerChannel ()  ; 
-WaveRunnerChannel (void)  ; 


WAVERUNNERCHANNEL.CPP 

#include  "StdAfx.h" 

#include  "waverunnerchannel . h" 

WaveRunnerChannel :  : WaveRunnerChannel ( )  { }  ; 

WaveRunnerChannel : : -WaveRunnerChannel (void) 

{ 

} 

RXCHANNEL.H 

#pragma  once 

#include  "waverunnerchannel . h" 
class  RxChannel  : 
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public  WaveRunnerChannel 


{ 

public : 

unsigned  int  groupsSaved; 

RxChannel (unsigned  short  chanNum=0, 

unsigned  long  freq=23500000, 
unsigned  short  k=2, 
unsigned  long  dataRate=50000, 
CString  dfile=""); 

~RxChannel (void) ; 

int  setFrequency (unsigned  long  frequency); 

}; 


RXCHANNEL.CPP 

#include  "StdAfx.h" 
#include  "math.h" 
#include  "rxchannel . h" 
#include  "Memory_Map . h" 


Rxchannel :: Rxchannel (unsigned  short  chanNum, 

unsigned  long  freq, 
unsigned  short  kmod 
unsigned  long  dRate 
CString  dFile) 

{ 

channelNumber=chanNum; 
f requency=f req; 
k=kmod; 

dataRate=dRate; 
dataFileName=dFile ; 
dataBuf f er=NULL ; 
groupsTransf ered=0 ; 
threadRunning=f alse  ; 
terminateProcess=true ; 
threadReady=f alse; 
groupCount=0 ; 
if  (channelNumber<4 ) 

{ 

of f setAddress=0x40000 ; 
channelOf f set=channelNumber ; 

} 

else 

{ 

of f setAddress=0x80000 ; 
channelOf fset=channelNumber-4 ; 

} 

setFrequency (freq) ; 
groupsSaved=0 ; 


Rxchannel 


Rxchannel (void) 


{ 

} 


int  RxChannel :: setFrequency (unsigned  long  freq) 

{ 

f requency=f req; 


int  ioError=-4; 
if  (wr->conf igured) 

{ 

unsigned  long 

f reqAddress=of f setAddress+4* (OxlOOO*channelOf f set+5) ; 

unsigned  long  f reqValue=unsigned 
long ( f req*pow (2 , 32 ) /WaveRunner : : rxClockFrequency ) ; 

ioError=WriteWaveRunner (freqAddress,  freqValue) ; 
If  (  ! ioError ) 


{ 

ioError=WriteWaveRunner ( f reqAddress  +  4 ,  freqValue 

0x1)  ; 

} 


} 

return  ioError; 


& 


TXCHANNEL.H 

#pragma  once 

#include  "waverunnerchannel . h" 

class  TxChannel  : 

public  WaveRunnerChannel 

{ 

public : 

unsigned  int  groupsLoaded; 
unsigned  short  attenuation; 

-TxChannel (void) ; 

TxChannel (unsigned  short  chanNum=0, 

unsigned  long  freq=23500000, 
unsigned  short  k=2, 
unsigned  long  dataRate=50000, 
CString  dfile=""); 

Int  setFrequency (unsigned  long  frequency); 
Int  setDataRate (unsigned  long  dataRate) ; 

}; 


TXCHANNEL.CPP 

#include  "StdAfx.h" 
#include  "math.h" 
#lnclude  "GlobalVars . h" 
#lnclude  "txchannel . h" 
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//#include  "pmcradioi . h 


TxChannel :: TxChannel (unsigned  short  chanNum, 
unsigned  long  freq, 
unsigned  short  kmod, 
unsigned  long  dRate, 
CString  dFile) 

{ 

channelNumber=chanNum; 

k=kmod; 

dataFileName=dFile ; 
dataBuf f er=NULL ; 
groupsTransf ered=0 ; 
threadRunning=f alse ; 
terminateProcess=true  ; 
threadReady=f alse; 
groupCount=0 ; 
attenuation=l ; 

If  (channelNumber<4 ) 

{ 

of f setAddress=0xl0000 ; 
channelOf f set=channelNumber ; 

} 

else 

{ 

of f setAddress=0xl02  00 ; 
channelOf fset=channelNumber-4 ; 

} 

setFrequency (freq) ; 
setDataRate (dRate) ; 
groupsLoaded=0 ; 


TxChannel : : ~TxChannel (void) 

{ 

} 


int  TxChannel :: setFrequency (unsigned  long  freq) 

{ 

int  ioError=-4; 
f requency=f req; 
if  (wr->conf igured) 

{ 

unsigned  long 

f reqAddress=of f setAddress+4* (0x20*channel0ffset+0x8) ; 

unsigned  long  f reqValue=unsigned 
long ( f req*pow (2 , 32 ) /WaveRunner : : txClockFrequency ) ; 
unsigned  long  Ifreq,  ufreq; 
uf req= ( f reqValue  &  OxFFFFOOOO) >>16; 

If req=f reqValue  &  OxFFFF; 

ioError=WriteWaveRunner (freqAddress,  ufreq) ; 
If  (  !  ioError ) 

{ 

ioError=WriteWaveRunner ( f reqAddress  +  4 , 

} 


Ifreq) ; 
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} 

return  ioError; 


int  TxChannel :: setDataRate (unsigned  long  dRate) 

{ 

dataRate=dRate; 
int  ioError=-4; 
if  (wr->conf igured) 

{ 

unsigned  long 

f reqAddress=of f setAddress  +  4* (0x20*channel0ffset  +  0x4)  ; 

unsigned  _int64  symbolRate=unsigned  _int64 (dataRate) ; 
unsigned  _int64  mult=unsigned  _int64 (pow (2, 48) ) ; 
double 

divisor=double (pow (2,48) ) *dataRate/WaveRunner : : txClockFrequency ; 

unsigned  _int64  dataValue=unsigned  _int64 (divisor) ; 
unsigned  long  Ifreq,  mfreq,  ufreq; 

If req=dataValue  &  OxFFFF; 

mf req= (dataValue  &  OxFFFFOOOO) >>16; 

uf req= (dataValue  &  OxFFFFOOOOOOOO ) >>32 ; 

ioError=WriteWaveRunner (freqAddress,  ufreq) ; 

if  (  !  ioError) 

{ 

ioError=WriteWaveRunner ( f reqAddress+4 ,  mfreq) ; 
if  (  !  ioError) 

{ 

ioError=WriteWaveRunner ( f reqAddress  +  8 ,  Ifreq) 


} 

} 

return  ioError; 


WAVERUNNERISR.CPP 


#include 

#include 

#include 

#include 

#include 

#include 

#include 

#include 


"StdAfx.h" 
"afxmt . h" 
"Math.h" 
"direct . h" 
"RxChannel.h" 
"TxChannel. h" 
"Memory_map . h" 
"resource . h" 


//Define  and  initialize  Global  Structures  and  variables 
ChannelStatus  txChannelStatus [8] ; 

ChannelStatus  rxChannelStatus [8] ; 

Channelinfo  txChannelInf o [ 8 ] ; 

Channelinfo  rxChannelInf o [ 8 ]  ; 


CCriticalSection  cSection; 

CEvent  allChannelsReady,  allChannelsDone; 
CEvent  txBuf f erEmpty [ WaveRunner : : maxChannels ] 


rxBuf f erFull [ WaveRunner : : maxChannels ] ; 


^^-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

//  Interrupt  Service  Routine.  The  contents  of  the  Interrupt 
//  Status  Register  are  stored  in  the  variable  "Status".  Also, 

//  interrupts  have  been  disabled,  so  we  need  to  re-enable  them 
//  before  exiting  the  routine. 

^^i^-ki^-ki^-ki^-ki^-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

void  PMCRadioIsrO (unsigned  long  status) 

{ 

//Determine  if  interrupt  is  due  to  the  card 
if  ((status  &  _GLOBAL_INTERRUPT) !=0) 

{ 

//  If  interrupt  is  due  to  a  Rx  FIFO  interrupt 
if  ((status  &  0x1) !=0) 

{ 

unsigned  long  FIFOStatus; 
unsigned  short  rxChFIFO; 

//Read  Rx  FIFO  Interrupt  Status 
ReadWaveRunner (_RECEIVE_FIFO_INTERRUPT_STATUS, 
SFIFOStatus) ; 

//For  each  rx  channel 

for  (int  rxCh=0;  rxCh<wr->rxChannelsCount ;  rxCh++) 

{ 

//Check  to  see  if  the  channel  has  caused  the 

interrupt 

rxChFIFO= (FIFOStatus  &  (OxF  «  (4*rxCh)))  >> 

(4*rxCh)  ; 

if  (rxChFIFO!=0) 

{ 


rxChannelInf o [ rxCh] . FIFOInterruptStatus=true ; 
rxChannelInf o [rxCh] . FIFOInterruptMask=rxChFIFO; 


} 

} 

//  If  interrupt  is  due  to  a  receive  channel  DMA  complete 
if  ((status  &  0x4) !=0) 

{ 

//For  every  rxChannel 

for  (int  rxCh=0;  rxCh<wr->rxChannelsCount ;  rxCh++) 

{ 

//If  the  channel  was  the  cause  of  the  interrupt 
if ( (status  &  (0xl<<  ( 4+rxCh) ) ) ! =0 ) 

{ 

//increase  the  channel  counter  of 

transfered  blocks 

wr->rxChannel [rxCh] ->groupsTransf ered++; 
unsigned  long  buffer; 
if  (rxCh<4) 

{ 

ReadWaveRunner (0x10,  &buffer) ; 


else 
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{ 

ReadWaveRunner (0x14,  Sbuffer) ; 

} 

unsigned  short  ch=rxCh; 
if  (rxCh>3) {ch=ch-4; } 

wr->rxChannel [rxCh] ->groupCount= ( (buffer 
&  (OxFF  «  (8*ch)))  >>  (8*ch)); 

//Set  event  to  wake  up  channel  thread 
rxBuf f erFull [ rxCh] . Set Event ( ) ; 


//  If  interrupt  is  due  to  a  Tx  FIFO  interrupt 
if  (  (status  &  0x2)  !=0) 

{ 

unsigned  long  FIFOStatus; 
unsigned  short  txChFIFO; 

//Read  Rx  FIFO  Interrupt  Status 
ReadWaveRunner (_TRANSMIT_FIFO_INTERRUPT_STATUS, 
SFIFOStatus) ; 

//For  each  rx  channel 

for  (int  txCh=0;  txCh<wr->txChannelsCount ;  txCh++) 

{ 

//Check  to  see  if  the  channel  has  caused  the 

interrupt 

txChFIFO= (FIFOStatus  &  (OxF  «  (4*txCh)))  >> 

(4*txCh)  ; 

if  (txChFIFO!=0) 

{ 


txChannelInf o [txCh] . FIFOInterruptStatus=true ; 
txChannelInf o [txCh] . FIFOInterruptMask=txChFIFO; 


} 

} 

//  If  interrupt  is  due  to  a  transmit  channel  DMA  complete 
if  ((status  &  0x8) !=0) 

{ 

//For  every  txChannel 

for  (int  txCh=0;  txCh<wr->txChannelsCount ;  txCh++) 

{ 

//If  the  channel  was  the  cause  of  the  interrupt 
if ( (status  &  (0xl<<  ( 12+txCh) ) ) ! =0 ) 

{ 

//increase  the  channel  counter  of 

transfered  blocks 

wr->txChannel [txCh] ->groupsTransf ered++; 
unsigned  long  buffer; 
if  (txCh<4) 

{ 

ReadWaveRunner (0x18,  &buffer) ; 

} 

else 

{ 

ReadWaveRunner ( OxlC,  &buffer) ; 

} 
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unsigned  short  ch=txCh; 
if  (txCh>3) {ch=ch-4; } 

wr->txChannel [txCh] ->groupCount= ( (buffer 
&  (OxFF  «  (8*ch)))  >>  (8*ch)); 

txBuf ferEmpty [txCh] .SetEvent () ; 


} 

} 

//Enable  interrupts 

WriteWaveRunner (_GLOBAL_INTERRUPT_MASK,  0x1) ; 

} 

//************************************************ 

//  This  is  the  main  "parent"  thread  which  controls 
//  the  Rx  and  Tx  channels  threads. 

^ /************************************************ 

UINT  mainRxTxThread (LPVOID  pParam) 

{ 

CWnd*  parentWindow  =  (CWnd*)  pParam; 

//As  a  first  step,  allocate  memory  space  for  the  channels 
wr->threadsReady=0 ; 

//Try  to  configure  the  card 
int  error=wr->Conf igure ( ) ; 

If  (error) 

{ 

wr->Close  ( ) ; 

CString  disp; 

disp="WaveRunner  not  properly  configured . \n  Process  will 

abort . " ; 

return  error; 

} 

//  Configure  channels  by  passing  the  parameters  stored  in  the 
.  .  info  tables 

//  Then  start  channels  threads 

for  (Int  channel=0 ; channel<wr->maxChannels; channel++) 

{ 

If  (channel<wr->txChannelsCount ) 

{ 

txChannelStatus [channel] . status- 
>SetWindowText ("Initializing")  ; 

wr->txChannel [channel] - 

>setFrequency (txChannelInfo [ channel ] .frequency) ; 

wr->txChannel [channel] ->k=txChannelInf o [channel]  .  k; 
wr->txChannel [channel] - 
>setDataRate (txChannelInfo [ channel ] .datarate) ; 

wr->txChannel [channel] - 

>attenuation=txChannelInf o [channel] . attenuation; 

txChannelInfo [ channel ] . FIFOInterruptStatus=f alse ; 
txChannelInfo [ channel ] . FIFOInterruptMask=0 ; 
char  fName [ 80 ] ; 

Int  pos=0; 
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for  (int  letter=0; 

letter<txChannelInf o [ channel ] . f ileName . GetLength ( ) ;  letter++) 

{ 

fName [pos] =txChannelInf o [channel] . fileName [letter] ; 
pos++; 

If 

(txChannelInf o [channel] . fileName [letter] ==92) 

{ 

fName [pos ] =92 ; 
pos++; 


fName [pos ] =0 ; 

wr->txChannel [channel] ->dataFileName=fName; 
wr->txChannel [channel] ->groupsLoaded=0 ; 
wr->txChannel [channel] ->groupsTransf ered=0  ; 
wr->txChannel [channel] ->terminateProcess=f alse ; 
Af xBeginThread (txThread, LPVOID (channel) )  ; 

} 

else 

{ 

wr->txChannel [channel] ->setDataRate (0)  ; 


for  (int  channel=0 ; channel<wr->rxChannelsCount ; channel++) 

{ 

rxChannelStatus [channel] . status- 
>SetWindowText ("Initializing") ; 

wr->rxChannel [channel] - 

>setFrequency (rxChannelInfo [channel] .frequency) ; 

wr->rxChannel [ channel ] ->k=rxChannelInf o [ channel ] . k ; 
wr->rxChannel [channel] - 
>dataRate=rxChannelInf o [ channel ] . data rate ; 

rxChannelInfo [ channel ] . FIFOInterruptStatus=f alse ; 

rxChannelInfo [channel] . FIFOInterruptMask=0 ; 

char  fName [ 80 ] ; 

int  pos=0; 

for  (int  letter=0; 

letter<rxChannelInf o [ channel ] . fileName . GetLength () ;  letter++) 

{ 

fName [pos] =rxChannelInf o [channel] . fileName [letter] ; 
pos++; 

if  (rxChannelInfo [channel] . fileName [ letter ] ==92 ) 

{ 

fName [pos ] =92 ; 
pos++; 


fName [pos ] =0 ; 

wr->rxChannel [channel] ->dataFileName=fName; 
wr->rxChannel [channel] ->groupsTransf ered=0 ; 
wr->rxChannel [channel] ->groupsSaved=0 ; 
wr->rxChannel [channel] ->terminateProcess=f alse ; 

Af xBeginThread (rxThread, LPVOID (channel) ) ; 

} 

//Wait  until  all  threads  are  ready  to  transmit  or  receive 
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unsigned  long  regBuffer; 
allChannelsReady . ResetEvent ()  ; 

: : WaitForSingleOb ject (allChannelsReady,  INFINITE) ; 

//When  all  channels  are  ready,  enable  transmit  and  receive 
if  (wr->rxTxEnable) 

{ 

wr->enableRxTx ( ) ; 

} 

//Loop  that  checks  if  there  are  still  active  channels 
//or  if  a  stop  signal  has  been  issued 
: : WaitForSingleOb ject (allChannelsDone,  INFINITE) ; 

//while  (rxTxEnable  &  (rxThreadsRunning+txThreadsRunning>0 ) ) ; 
//When  activity  must  stop,  as  a  first  action  stop  the  card 
activity 

wr->disableRxTx ( )  ; 

//If  some  channels  are  still  running  but  a  terminate  signal  has 
been  issued 

//take  care  that  all  channel  activity  stops 
i f (wr->rxThreadsRunning+wr->txThreadsRunning>0 ) 

{ 

for  (int  channel=0 ; channel<wr->rxChannelsCount ;  channel+t) 

{ 

wr->rxChannel [channel] ->terminateProcess=true ; 

} 

for  (int  channel=0 ; channel<wr->txChannelsCount ;  channel++) 

{ 

wr->txChannel [channel] ->terminateProcess=true; 

} 

} 

//Make  sure  that  all  channels  have  finished 
CString  displayMessage="Inactive" ; 

for  (int  channel=0 ; channel<wr->rxChannelsCount ;  channel++) 

{ 

while (wr->rxChannel [channel] ->threadRunning)  ; 
rxBuf f erFull [ channel ] . ResetEvent ( ) ; 


for  (int  channel=0 ; channel<wr->txChannelsCount ;  channel++) 

{ 

while (wr->txChannel [channel] ->threadRunning) ; 
txBuff erEmpty [ channel ] .ResetEvent () ; 

} 

//If  all  channel  activity  has  been  terminated  but 

//no  stop  signal  has  been  issued,  notify  the  parent  window 

if (wr->rxTxEnable) 

{ 

parentWindow->PostMessage (WM_PROCESSES_FINISHED) ; 


//} 

return  error; 

} 

//********************************************************** 
//  This  is  the  thread  which  runs  for  every  RECEPTION  channel 
//********************************************************** 


UINT  rxThread (LPVOID  pParam) 

{ 


wr->rxThreadsRunning++ ; 
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int  channel=int (pParam) ; 

RxChannel*  rChannel=wr->rxChannel [ channel ] ; 
rChannel->threadRunning=true ; 
rChannel->groupsTransf ered=0 ; 
rChannel->groupsSaved=0 ; 
rChannel->groupCount=l ; 

CFile  targetFile; 

CString  tFile=rChannel->dataFileName . Lef t (rChannel- 
>dataFileName . GetLength ( ) -3) +"TMF" ; 

int  f ileOpenError=targetFile . Open  (tFile,  CFile :: modeCreate  | 
CFile: :modeWrite) ; 

if  ( f ileOpenError==0 ) 

{ 

CString  message; 

message . Format ( "Could  not  open  target  file  for  channel 
#%2i  .  \nChannel  will  abort channel ) ; 

AfxMessageBox (message)  ; 

} 

cSect ion . Lock ( ) ; 
wr->threadsReady++ ; 

if  (wr->threadsReady==wr->rxChannelsCount+wr->txChannelsCount ) 

{ 

allChannelsReady . SetEvent ()  ; 

} 

cSect ion . Unlock ( ) ; 

rxChannelStatus [ channel ] . status->SetWindowText ( " Idle . . . " ) ; 
bool  rxBuf f erOverFlow=f alse; 
if  ( f lleOpenError ! =0 ) 

{ 

unsigned  short  groupCount=l ; 

unsigned  long  rxGroupSize=wr->blockSize*wr- 
>rxBlocksPer Group ; 

bool  alreadySetStatus=f alse; 

//Loop  to  be  executed  while  there  is  data  to  save 
while  ( (wr->rxTxEnable)  &&  (  ! rxBuf f erOverFlow) ) 

{ 

:  : WaitForSingleOb ject (rxBuf ferFull [channel]  ,  INFINITE) ; 
rxBuf ferFull [ channel ] . Re set Event ( ) ; 
if  (rChannel->groupsTransf ered>r Channel - 
>groupsSaved+wr->rxGroupsPerChannel-l ) 

{ 

rxBuf f er Over FI ow=t rue ; 

} 

if  (rxChannelInfo [channel] . FIFOInterruptStatus ) 

{ 

rxBuf ferOverFlow=t rue  ; 

} 

if  ( (wr->rxTxEnable )  &&  (! rxBuf f erOverFlow) ) 

{ 

unsigned  long*  buf f erPos=rChannel- 
>dataBuffer+ (groupCount-1 ) *rxGroupSize; 

targetFile . Write (bufferPos,  4*rxGroupSize)  ; 

rChannel->groupsSaved++ ; 

groupCount++; 
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if  (groupCount>wr->rxGroupsPerChannel ) 

groupCount=l ; 

if ( ! alreadySetStatus ) 

{ 

rxChannelStatus [channel] . status- 
>SetWindowText ("Receiving.  .  . ; 

alreadySetStatus=true; 


tar get File .Close ( ) ; 

if  ( ( ! rxBuf f erOverFlow)  &&  (rChannel->k>l ) ) 

Demodulate (channel,  true)  ; 

/ /CFile :  : Remove (tFile )  ; 
rChannel->threadRunning=f alse  ; 
cSect ion . Lock ( ) ; 
wr->rxThreadsRunning — ; 

if  (wr->rxThreadsRunning+wr->txThreadsRunning==0 ) 

{ 

allChannelsDone . SetEvent ( ) ; 

} 

cSect ion . Unlock  ( ) ; 

CString  displayMessage="Inactive" ; 
if  (rxChannelInfo [channel] . FIFOInterruptMask) 

{ 

switch  (rxChannelInfo [channel] .FIFOInterruptMask) 

{ 

case  1 : 

displayMessage="FIFO  Underflow" ; 
break; 
case  8  : 

displayMessage="FIFO  Overflow" ; 
break; 
default : 

displayMessage="Inactive " ; 


rxChannelStatus [channel] . status->SetWindowText (displayMessage) ; 
rxChannelStatus [channel] . progress->SetPos (0) ; 
return  0; 

} 

//************************************************************* 

//  This  is  the  thread  which  runs  for  every  TRANSMISSION  channel 
//************************************************************* 

UINT  txThread (LPVOID  pParam) 

{ 

//Acquire  parameters 
int  channel=int (pParam) ; 

TxChannel*  tChannel=wr->txChannel [ channel ]  ; 
tChannel->threadRunning=true ; 
tChannel->groupsLoaded=0 ; 
tChannel->groupsTransf ered=0 ; 
tChannel->groupCount=l ; 
cSect ion . Lock ( ) ; 
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wr->txThreadsRunning++ ; 
cSect i on . Unlock  ( ) ; 

//Update  status  box 

txChannelStatus [ channel ] . status->SetWlndowText ( "Modulating 
//Modulate  data  Into  I  and  Q  channels 
CStrlng  txFlleName=Modulate (channel) ; 
txChannelStatus [channel] . progress->SetPos (0) ; 
bool  but f erUnderFlow=f alse ; 

If  (wr->rxTxEnable) 

{ 

txChannelStatus [channel] . status- 
>SetWlndowText ("Transmitting 
CFlle  txFlle; 

txFlle . Open (txFlleName, CFlle : : modeRead) ; 

unsigned  long  totalGroups=cell (txFlle . GetLength ()/ (4*wr- 
>blockSlze*wr->txBlocksPerGroup) ) ; 

unsigned  Int  symbolsRead=txFlle.Read(tChannel- 
>dataBuf fer, 4*wr->txChannelSlze)  / 4  ; 

//Initially  fill  all  the  channel  buffer  with  data 
If  ( symbol sRead<wr->t xChannelS 1 ze ) 

{ 

for  (Int  symbol=symbolsRead;  symbol<wr- 
>txChannelSlze;  symbol++) 

{ 

* (tChannel->dataBuf f er+symbol ) =0 ; 


cSectlon . Lock  ( ) ; 
wr->threadsReady++ ; 

If  (wr->threadsReady==wr->rxChannelsCount+wr- 
>txChannelsCount ) 

{ 

allChannelsReady . SetEvent () ; 

} 

cSectlon . Unlock ( ) ; 

tChannel->groupsLoaded=wr->txGroupsPer Channel ; 
unsigned  short  groupCount=l ; 

unsigned  short  txGroupSlze=wr->blockSlze*wr- 
>txBlocksPer Group ; 

//Loop  to  be  executed  while  there  Is  data  to  add 
while  ( (wr->rxTxEnable)  && 

(txFlle . Get Posit Ion ( ) <txFlle . GetLength ( ) )  &&  ( ! buf f erUnderFlow) ) 

{ 

:  : WaltForSlngleOb ject (txBuff erEmpty [ channel ]  , 

INFINITE) ; 

txBuff erEmpty [ channel ] .ResetEvent () ; 

If  (tChannel->groupsTransfered>tChannel- 
>groupsLoaded+wr->txGroupsPerChannel-l ) 

{ 

buf f erUnderFlow=true ; 

} 

If  (txChannelInfo [channel] . FIFOInterruptStatus ) 
If  (tChannel->groupsTransf ered<2 ) 

{ 

txChannelInfo [ channel ] . FIFOInterruptStatus=f alse ; 
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txChannelInf o [ channel ] . FIFOInterruptMask=0 ; 

} 

else 

{ 

buf f erUnderFlow=true ; 


If  ( (wr->rxTxEnable )  &&  ( ! buf f erUnderFlow) ) 

{ 

unsigned  long*  buf f erPos=tChannel- 
>dataBuffer+ (groupCount-1 ) *txGroupSize; 

if  (tChannel->k:==l )  txFile  .  SeekToBegin  ( )  ; 
unsigned  long 

symbolsRead=txFile . Read (buf ferPos,  4*txGroupSize) / 4 ; 

if  (symbolsRead<txGroupSize) 

{ 

for  (int  symbol=symbolsRead; 

symbol<txGroupSize;  symbol++) 

{ 


1 ) *txGroupSize+symbol ) =0  ; 


* (tChannel->dataBuf f er+ (groupCount- 


txChannelStatus [channel] .progress- 
>SetPos (100*tChannel->groupsLoaded/totalGroups) ; 

groupCount++; 

if  (groupCount>wr->txGroupsPerChannel ) 


groupCount=l ; 


tChannel->groupsLoaded++ ; 


txFile . Close ( ) ; 

/ / CFile :  : Remove (txFileName)  ; 

//Clearing  buffers  after  all  data  has  been  transfered 
for  (Int  group=l;  group<=wr->txGroupsPerChannel ;  group++) 

{ 

If  (wr->rxTxEnable) 

{ 

:  : WaitForSingleOb ject (txBuf f erEmpty [channel]  ,  INFINITE)  ; 

txBuff erEmpty [ channel ] .ResetEvent () ; 

} 

for  (Int  symbol=0;  symbol<txGroupSize ;  symbol++) 

{ 

* (tChannel->dataBuf f er+ (groupCount- 
1 ) *txGroupSize+symbol ) =0 ; 

} 

groupCount++; 

If  (groupCount>wr->txGroupsPerChannel )  groupCount=l ; 

} 

txChannelStatus [channel] . progress->SetPos (100) ; 

} 

cSect ion . Lock ( ) ; 
wr->txThreadsRunning — ; 

if  (wr->rxThreadsRunning+wr->txThreadsRunning==0 ) 

{ 


allChannelsDone . SetEvent ()  ; 
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cSect i on . Unlock  ( ) ; 

CString  displayMessage="Inactive" ; 
if  (txChannelInfo [ channel ] . FIFOInterruptMask) 

{ 

switch  (txChannelInfo [channel] .FIFOInterruptMask) 

{ 

case  1 : 

displayMessage="FIFO  Underflow" ; 
break; 
case  8 : 

displayMessage="FIFO  Overflow" ; 
break; 
default : 

displayMessage="Inactive " ; 


txChannelStatus [channel] . status->SetWindowText (displayMessage ) 
txChannelStatus [channel] . progress->SetPos (0) ; 
tChannel->threadRunning=f alse ; 
return  0; 


MODEMOD.CPP 

#include  "StdAfx.h" 

#include  "Math.h" 

#include  "direct. h" 

//Actual  Modulation  -  Demodulation  routines  declarations 
CString  mPSK_Modulate (int)  ; 
void  mPSK_Demodulate ( int ,  bool); 

//  Modulation  -  Demodulation  routines  entry  points 
//  Use  these  entry  points  just  to  select  the  appropriate 
//  routines  of  your  code. 

CString  Modulate (int  txChannelNum) 

{ 

return  mPSK_Modulate (txChannelNum) ; 

} 


void  Demodulate ( int  rxChannelNum,  bool  createLog) 

{ 

mPSK_Demodulate (rxChannelNum,  createLog) ; 

} 

//  M-PSK  MODULATION  ROUTINE 

//  This  routine  takes  the  data  from  the  transmission  file 
//  and  creates  the  file  of  symbols 

CString  mPSK_Modulate ( int  txChannelNum) 

{ 

unsigned  short  Amplitude=wr->maxAmplitude/wr- 
>txChannel [txChannelNum] ->attenuation; 


short  header [24] ={1, 1, 1,1, 1,1, 1,1, 1,1, 1,1, 1,1, 1,1, -1,-1, 1,1,- 

1,  1,-1, 1}; 

short  k=wr->txChannel [txChannelNum] ->k; 
char  M=pow(2,k); 

short  symbolsPerPacket=wr->blockSize-32 ; 
short  bytesPerPacket=symbolsPerPacket*k/ 8 ; 
char  dataBuf f erin [wr->blockSize/2 ] ; 
int  dataBuf ferOut [ wr->blockSize ]  ; 

UINT  actualBytesRead,  actualSymbolsToWrite; 

CFile  sourceFile,  targetFile; 
int  I,  Q; 

char  sampleBuf f er ; 
float  initialPhase; 
unsigned  long  nBuffer; 

unsigned  short  dataMask,  bytesToRead,  symbolsToWrite; 

CString  sFile=wr->txChannel [txChannelNum] ->dataFileName; 
CString  tFile=sFile.Left (sFile. Get Length ( ) -3) +"TMF" ; 
targetFile . Open (tFile,  CFile :: modeCreate  |  CFile : :modeWrite) ; 

//  If  test  tone  selected,  simply  write  a  series  of  1=1  and  Q=0 
//  and  exit 
if  (k==l) 

{ 

int  buf fer [ 9000 ] ; 
for  (int  k=0;  k<9000;  k++) 
buffer [k] =Amplitude; 
targetFile . Write (buf fer ,  36000); 
targetFile .Close ( ) ; 

txChannelStatus [txChannelNum] . progress->SetPos (100) ; 
return  tFile; 

} 

sourceFile . Open ( sFile, CFile : :modeRead) ; 

switch  (k) 

{ 

case  2  : 

bytesToRead=l ; 
symbolsToWrite=4 ; 
dataMask=0x3 ; 
initialPhase=0 ; 
break; 
case  3: 

bytesToRead=3 ; 
symbolsToWrite=8 ; 
dataMask=0x7 ; 
initialPhase=0 ; 
break; 
case  4  : 

bytesToRead=l ; 
symbolsToWrite=2 ; 
dataMask=0xF ; 
initialPhase=0 ; 

} 

//Find  number  of  data  packets  in  the  file 
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float 

packetNum=f loat ( sour ceF lie . Get Length ( ) ) /float (bytesPer Packet )  ; 
unsigned  Int  totalPackets=ceil (packetNum) ; 

Int  packet=0; 

//  While  RxTx  Is  enabled  and  packets  remaining  to  be  modulated 
while  ( (wr->rxTxEnable)  &  (packet<totalPackets) ) 

{ 

//  Update  progress  bar 

txChannelStatus [txChannelNum] . progress->SetPos ( 

100*  (packet  +  1) /totalPackets ) ; 

//  Fill  data  buffer 

actualBytesRead=sourceFile . Read (dataBuf f erin, 
bytesPerPacket )  ; 

actualSymbolsToWrite=ceil (actualBytesRead*8/k)  ; 

//  Write  packet  header  using  BPSK  modulation 
for  (int  sample=0;  sample<24;  sample++) 

dataBuf ferOut [ sample] =Amplitude*header [ sample]  ; 

//  Write  number  of  samples  per  packet  using  QPSK  modulati 
for  (sample=0;  sample<8;  sample++) 

{ 

sampleBuf f er=  (actualSymbolsToWrite  &  (0x3  << 

(2*sample) ) )  >>  (2*sample) ; 

I=Amplitude*cos (2*pi*sampleBuf fer/4  +  initialPhase) 
Q=Amplitude*sin (2*pi*sampleBuf fer/4  +  initialPhase) 
dataBuf ferOut [sample+24] =I | (Q<<16) ; 

} 

//  Write  actual  data  in  M-PSK 

unsigned  int  bytelndexln=0 ,  symbolIndexOut=0 ; 
while  (byteIndexIn<actualBytesRead) 

{ 

//Form  the  integer 
nBuf f er=0 ; 

for  (short  byte=0;  byte<bytesToRead;  byte++) 

{ 


if  (byteIndexIn<actualBytesRead) 

{ 


nBuf fer=nBuffer+ (dataBuf ferin [byteindexin]  <<  (8*byte)); 

bytelndexln++ ; 


} 

//For  each  symbol  in  the  buffer  calculate  and  store 
the  I  and  Q  channels 

for  (unsigned  short  symbol=0;  symbol<symbolsToWrite 


symbol++) 


{ 


(k*symbol) ) )  >> 
initialPhase) ; 
initialPhase) ; 

} 


sampleBuf fer= (nBuf fer  &  (dataMask  << 
(k*symbol) ; 

I=Amplitude*cos (2*pi*sampleBuf fer/M  + 

Q=Amplitude*sin (2*pi*sampleBuf fer/M  + 

dataBuf ferOut [ 32  +  symbolIndexOut ] =I I  (Q<<1 6 ) ; 
symbol I ndexOut++ ; 


//  Write  buffer  to  target  file 


targetFile . Write (dataBuf f erOut , 

4* (32+actualSymbolsToWrite) )  ; 
packet++; 

} 

sourceFile .Close  ( ) ; 
targetFile .Close  ( ) ; 

txChannelStatus [txChannelNum]  . progress->SetPos  (100) ; 
return  tFile; 

} 


//  M-PSK  DEMODULATION  ROUTINE 

//  This  routine  translates  the  previouly  stored  samples 
//  into  symbols  and  bits 

void  mPSK_Demodulate ( int  rxChannelNum,  bool  createLog) 

{ 

rxChannelStatus [ rxChannelNum] . status->SetWindowText ( "Demodulating 

..."); 

rxChannelStatus [rxChannelNum] . progress->SetPos (0) ; 

RxChannel*  rChannel=wr->rxChannel [ rxChannelNum] ; 
char  k=rChannel->k; 

CString  tFile=rChannel->dataFileName ; 

CString  sFile=t File. Left (tFile. Get Length ( ) -3) +"TMF" ; 

CFile  sourceFile,  targetFile; 

CStdioFile  logFile; 

sourceFile . Open (sFile,  CFile: :modeRead) ; 

targetFile . Open (tFile,  CFile :: modeCreate  |  CFile : :modeWrite) ; 
if  (createLog) 

{ 

CString  logFileName; 
logFileName . Format ( "RxChannel  #%lu 
log . txt " , rxChannelNum+1 ) ; 

logFile . Open (logFileName, CFile : : modeWrite  | 

CFile: :modeCreate) ; 

logFile . WriteString ( "  Packet  ##  Found  at  Phase  offset 
Synced  at  ##  symbolsVn"); 

logFile .WriteString (" - 

- \n") ; 

} 

unsigned  int  totalSamples=sourceFile . GetLength ( ) /4 ; 

//  Set  variables 
float  M=pow(2,  k) , 

anglePerSymbol=2*pi/M, 
power Thr e sho ld=5 0 , 
rat ioThreshold=l 1 , 
of f setThreshold=4*pi/ 180 ; 
unsigned  short  samplingPoint=2 , 

symbolsPer Packet , 

samplesPerSymbol=4 ; / /  S.  0.  S.  rChannel- 

>dataRate 

unsigned  int  packetNum=0 , f oundAt=0 ,  syncedAt=0; 
short  sampleBuf f er [ 8 1 92 ]  [2]; 
char  symbolBuf fer [ 1024 ] ; 
char  dataBuf fer [ 1024 ] ; 
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int  actualSamplesRead; 

//  Create  Sync  Sequence 

short  Barker [13] ={1, 1 , 1 , 1 , 1 , -1 , -1 , 1 , 1 , -1 , 1 , -1 , 1 } ; 
short  syncSequence [ 104 ] ; 
for  (int  1=0;  i<13;  i++) 

for  (int  j=0;  j<samplesPerSymbol;  j++) 

syncSequence [ i * sample sPerSymbol+j ] =Barker [ i ] ; 

unsigned  short  symbolsToRead,  bytesToWrite; 
char  dataMask; 
float  initialPhase; 
switch  (k) 

{ 

case  2 : 

symbolsToRead=4 ; 
bytesToWrite=l ; 
dataMask=0x3 ; 
initialPhase=0 ; 
break; 
case  3: 

symbolsToRead=8 ; 
bytesToWrite=3 ; 
dataMask=0x7 ; 
initialPhase=0 ; 
break; 
case  4  : 

symbolsToRead=2 ; 
bytesToWrite=l ; 
dataMask=0xF ; 
initialPhase=0 ; 


int  currentSample=0 ; 

/ /  For  every  received  packet 
while  ( cur rent Sample<t ot alSamples ) 

{ 

//  Find  where  actual  data  starts  being  transmitted, 

/ /  by  measuring  the  average  power 
int  averagePower=0 ; 

while  ( (averagePower<powerThreshold)  && 
(currentSample<totalSamples) ) 

{ 

actualSamplesRead=sourceFile . Read ( sampleBuf f er , 
4*samplesPerSymbol) / 4 ; 

if  (actualSamplesRead==0 )  break; 
averagePower=0 ; 

for  (int  i=0 ; i<actualSamplesRead;  i++) 

{ 

unsigned  int 

samplePower=sqrt (pow ( sampleBuf fer [ i ]  [ 0 ] , 2 ) +pow ( sampleBuf fer [ i ]  [  1  ] , 2 ) ) ; 

aver agePower=averagePower+s amp lePower ; 

} 

averagePower=averagePower/ actualSamplesRead; 
cur r ent S amp le=cur rents amp le+actua IS amp lesRead; 

} 

if  (actualSamplesRead==0 )  break; 
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//  Advance  by  one  symbol 

actualSamplesRead=sourceFile . Read ( sampleBuf f er , 
4*samplesPerSymbol) / 4 ; 

if  (actualSamplesRead==0 )  break; 

cur r ent S amp le=cur r ent Sample fact ua IS amp lesRe ad; 


1]  [0]  )  ; 


//Synchronize  in  phase 
short  phaseHits=0; 

float  phaseOf f set=0 ,  previousOf f set=0 ,  totalOf f set=0 ; 
previousOf f set=atan2 ( sampleBuf fer [ 2*samplesPer Symbol- 1 ]  [ 1 ]  , 

sampleBuf fer [ 2*samplesPer Symbol- 


while  (phaseHits<6) 

{ 


actualSamplesRead=sourceFile . Read ( sampleBuf fer , 
4*samplesPerSymbol) / 4 ; 

if  (actualSamplesRead==0 )  break; 

cur r ent S amp le=cur rents amp le+actua IS amp lesRead; 

phaseOf f set=0 ; 

for  (int  1=0;  i<actualSamplesRead;  i++) 


phaseOf f set =phaseOff set +atan2 ( sampleBuf fer [ 1  ]  [ 1  ]  , 
sampleBuf fer [ 1 ]  [ 0  ]  )  ; 

phaseOf f set =phaseOff set /actual Samp lesRead; 
if  (abs (phaseOf fset-previousOff set ) <of f setThreshold) 
{ 

phaseHits++ ; 

totalOf f set=totalOf f set+phaseOf f set ; 

} 

else 

{ 

phaseHits=0 ; 
totalOffset=0; 

} 

previousOf f set =phaseOff set ; 


if  (actualSamplesRead==0 )  break; 
phaseOf f set =t Ota lOff set / 6 ; 
packetNum++ ; 
f oundAt=currentSample ; 

//Synchronize  in  time; 
bool  syncFound=f alse; 
int  syncPosition; 

actualSamplesRead=sourceFile . Read ( sampleBuf fer , 
13*4*samplesPerSymbol) / 4 ; 

if  (actualSamplesRead==0 )  break; 
double  prevCorr=0; 

while  ( ( ! syncFound)  &&  (actualSamplesRead>0 ) ) 

{ 

double  power=0,  normalizedCorr=0 ,  corr=0; 
for  (int  1=0;  i<13*samplesPerSymbol;  i++) 

{ 

int 

mag=sqrt (pow ( sampleBuf fer [ 1 ] [ 0 ] , 2 ) +pow ( sampleBuf fer [ 1 ] [ 1 ] , 2 ) ) ; 
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double  angle=atan2 ( sampleBuf f er [ i ] [1], 
sampleBuf f er [ i ] [ 0 ] ) -phaseOf f set ; 

corr=corr+mag*cos (angle) *syncSequence [i]  ; 
power=power +mag ; 

} 

corr=abs (corr) ; 

power=power/ 13 ; 

normal izedCorr=corr /power ; 

if  ( (normalizedCorr<prevCorr )  && 

(power>powerThreshold)  &&  (prevCorr>ratioThreshold) ) 

{ 

syncFound=true; 
syncPosition=currentSample-l ; 

current Sample=syncPos it ion+1 3* samplesPer Symbol ; 
sourceFile . Seek (-4 , CFile : : current ) ; 

} 

else 

{ 

prevCorr=normalizedCorr ; 
cur rents amp le++ ; 

for  (int  i=0;  i<13*samplesPerSymbol-l ; i++) 

{ 

sampleBuf fer [ i ] [ 0 ] =sampleBuf f er [ i+1 ] [0]; 
sampleBuf fer [ i ] [ 1 ] =sampleBuf f er [ i+1 ] [1]; 

} 

short  tmpBuf fer [2 ] ; 

actualSamplesRead=sourceFile . Read (tmpBuf fer, 

4)  /4; 

if  (actualSamplesRead==0 )  break; 
sampleBuf fer [ 13*samplesPerSymbol- 

1 ]  [ 0 ] =tmpBuf f er [ 0 ]  ; 

sampleBuf fer [ 13*samplesPerSymbol- 

1 ]  [ 1 ] =tmpBuf f er [ 1 ]  ; 

} 

} 

if  (actualSamplesRead==0 )  break; 
syncedAt=syncPosition; 

//  Find  the  number  of  symbols  per  packet 
//  Always  modulated  at  QPSK 

actual SamplesRead=sourceFile . Read ( sampleBuf fer , 32* samplesPer Symbo 

1)  /4; 

if  (actualSamplesRead<2*samplesPerSymbol)  break; 
currentSample=currentSample+actualSamplesRead; 
symbolsPerPacket=0  ; 
for  (int  i=0;  i<8;  i++) 

{ 

double 

phase=atan2 ( sampleBuf fer [ i*samplesPerSymbol  +  samplingPoint ]  [1]  , 

sampleBuf fer [ i* samplesPer Symbol+samplingPoint ] [ 0 ] ) -phaseOf f set ; 
if  (phase<0)  phase=phase+2*pi; 
if  (phase>2*pi)  phase=phase-2*pi; 
float  decision=2*phase/pi; 
int  iDecision; 

if  (ceil (decision) -decision<0 . 5) 
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iDecision=ceil (decision) ; 

else 

iDecision=floor (decision) ; 
if  ( iDecision==4 )  iDecision=0; 

symbolsPerPacket=symbolsPerPacket  |  (iDecision  << 

} 

if  (createLog) 

{ 

CString  logBuffer; 

logBuf fer . Format ("%12u%12u%12.2f%12u%12u\n", 

packetNum, f oundAt , phaseOf f set ,  syncedAt ,  symbolsPer Packet ) ; 
logFile .WriteString (logBuf fer) ; 

} 


//  Demodulate  the  packet 

actualSamplesRead=sourceFile . Read ( sampleBuf f er , 
4*symbolsPerPacket*samplesPerSymbol) / 4 ; 

if  ( act ualSamplesRead<symbolsPerPacket* sample sPer Symbol ) 

break; 

cur r ent S amp le=cur r ent Sample fact ua IS amp lesRe ad; 

//  Find  the  symbols 

for  (int  i=0;  i<symbolsPerPacket ;  i++) 

{ 

double 

phase=atan2 ( sampleBuf fer [ 1* sample sPerSymbol+samplingPoint ] [ 1 ] , 

sampleBuf fer [ i*samplesPerSymbol+samplingPoint ] [0] ) 

-phaseOf f set ; 

if  (phase<0)  phase=phase+2*pi; 
if  (phase>2*pi)  phase=phase-2*pi; 

float  decision= (phase-initialPhase) / anglePer Symbol ; 
int  iDecision; 

if  (ceil (decision) -decision<0 . 5) 
iDecision=ceil (decision) ; 

else 

iDecision=floor (decision) ; 
if  ( iDecision==M)  iDecision=0; 
symbolBuf f er [i] =iDecision; 

} 

//  Construct  the  bytes 

UINT  byteCount=0,  symbolsCount=0 ; 

while  ( symbolsCount< symbolsPer Packet ) 

{ 

//Form  the  integer 
int  nBuffer=0; 

for  (short  symbol=0;  symbol<symbolsToRead;  symbol++) 

{ 

if  ( symbolsCount< symbolsPer Packet ) 

{ 

nBuf f er=nBuf f er  | 

int ( symbolBuf fer [ symbolsCount ] << (k*symbol) ) ; 

symbol sCount++; 
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byte++) 

(8*byte) ) )  >> 


//Find  and  store  the  corresponding  bytes 
for  (unsigned  short  byte=0;  byte<bytesToWrite; 

{ 

dataBuf f er [byteCount ] = (nBuf f er  &  (OxFF  << 

(8*byte) ; 

byteCount++; 


tar get File .Write (dataBuf fer,  byteCount ) ; 
rxChannelStatus [ rxChannelNum] .progress- 
>SetPos (100*currentSample/totalSamples) ; 

} 

if  (createLog)  logFile . Close () ; 
sourceFile .Close  ( ) ; 
targetFile . Close  () ; 

} 


MEMORY_MAP.H 

^^-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k-k 

//*  PCI  CONFIGURATION  SPACE  REGISTERS  * 

^^-k-k-kk-k-k-kk-k-k-kk-k-k-k-k-k-k-k-k-k-k-k-k-k-k-kk-k-k-kk-k-k-kk-k 


#def ine 


RECEIVE_DESTINATION_ADDRESS  0x048 


#def ine 
#def ine 
#def ine 
Recommended 
#def ine 
#def ine 
#def ine 
set 

#def ine 


RECEIVE_DMA_CONTROL 

.IO_WRITE 

MEMORY_WRITE 

CONFIGURATION_WRITE 
PMA_ADDRESS_INCREMENT 
.6  4_B I T_TRANSFER_ENABLE 

SMART_DMA 


0x04C 

0x40 

0x70  // 


OxbO 

0x08 

0x04  //  Must  be  always 

0x01 


#define  _TRANSMIT_SOURCE_ADDRESS 


0x050 


#define  _TRANSMIT_DMA_CONTROL 

#define  _IO_READ 

#define  _MEMORY_READ 

Recommended 


#define  _CONFIGURATION_READ 

//  _DMA_ADDRESS_INCREMENT 

//  _64_BIT_TRANSFER_ENABLE 

/ /  _SMART_DMA 


/ ^kkkkkkkkkkkkkkkkkkkkkkkkkkkk 

//*  PCI  MEMORY  MAP  REGISTERS  * 
/ /**************************** 


0x054 

0x020 
0x060  // 

OxOAO 
as  above 
as  above 

as  above 


#def ine 
#def ine 
#def ine 
#def ine 


RCV_CHANNELS_3_0_GROUP_COUNT  0x000010 
RCV_CHANNELS_7_4_GROUP_COUNT  0x000014 
TRX_CHANNELS_3_0_GROUP_COUNT  0x000018 
TRX_CHANNELS_7_4_GROUP_COUNT  OxOOOOlC 
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#def ine 

_F  I RMWARE_VERS I ON 

0x000020 

#def ine 

_BOARD_STATUS 

0x000024 

#def ine 

_TX_PLL_STATUS 

0x010 

#def ine 

_DISCRETE_INPUT_3 

0x008 

#def ine 

_DISCRETE_INPUT_2 

0x004 

#def ine 

_DISCRETE_INPUT_1 

0x002 

#def ine 

_DISCRETE_INPUT_0 

0x001 

#def ine 

_INTERRUPT_STATUS 

0x000028 

#def ine 

_GLOBAL_INTERRUPT 

0x80000000 

#def ine 

_TX_PROCESSING_COMPLETE 

0x04000000 

#def ine 

_RX_PROCESSING_COMPLETE 

0x02000000 

#def ine 

_AUTO_DMA_ABORT_ID 

OxOlEOOOOO 

#def ine 

_DMA_ABORT_DETECTED 

0x00100000 

#def ine 

_TX_AREA_7_C0MPLETE 

0x00080000 

#def ine 

_TX_AREA_6_C0MPLETE 

0x00040000 

#def ine 

_TX_AREA_5_C0MPLETE 

0x00020000 

#def ine 

_TX_AREA_4_C0MPLETE 

0x00010000 

#def ine 

_TX_AREA_3_C0MPLETE 

0x00008000 

#def ine 

_TX_AREA_2_C0MPLETE 

0x00004000 

#def ine 

_TX_AREA_1_C0MPLETE 

0x00002000 

#def ine 

_TX_AREA_0_COMPLETE 

0x00001000 

#def ine 

_RX_AREA_7_C0MPLETE 

0x00000800 

#def ine 

_RX_ARE A_  6_C  OMP  L  E  T  E 

0x00000400 

#def ine 

_RX_ARE A_5_C  OMP  L  E  T  E 

0x00000200 

#def ine 

_RX_AREA_4_C0MPLETE 

0x00000100 

#def ine 

_RX_ARE A_3_C  OMP  L  E  T  E 

0x00000080 

#def ine 

_RX_ARE A_2_C  OMP  L  E  T  E 

0x00000040 

#def ine 

_RX_AREA_1_C0MPLETE 

0x00000020 

#def ine 

_RX_AREA_0_COMPLETE 

0x00000010 

#def ine 

_TX_DMA_COMPLETE 

0x00000008 

#def ine 

_RX_DMA_C  OMP  L  E  T  E 

0x00000004 

#def ine 

_TX_FIFO_INTERRUPT 

0x00000002 

#def ine 

_RX_FIFO_INTERRUPT 

0x00000001 

#def ine 

_RECEIVE_FIFO_INTERRUPT_STATUS 

0x00002C 

#def ine 

_MEM0RY_AREA_7 

OxFOOOOOOO 

#def ine 

_MEM0RY_AREA_6 

OxOFOOOOOO 

#def ine 

_MEM0RY_AREA_5 

OxOOFOOOOO 

#def ine 

_MEM0RY_AREA_4 

OxOOOFOOOO 

#def ine 

_MEM0RY_AREA_3 

OxOOOOFOOO 

#def ine 

_MEM0RY_AREA_2 

OxOOOOOFOO 

#def ine 

_MEM0RY_AREA_1 

OxOOOOOOFO 

#def ine 

_MEMORY_AREA_0 

OxOOOOOOOF 

#def ine 

_FIFO_UNDERFLOW 

ObOOOl 

#def ine 

_FIFO_EMPTY 

ObOOlO 

#def ine 

_FIFO_EXCEEDS_THRESHOLD 

ObOlOO 

#def ine 

_FIFO_OVERFLOW 

OblOOO 

#def ine 

_TRANSMIT_FIFO_INTERRUPT_STATUS  0x000030 

//#def ine 

_MEMORY_AREA_7 

OxFOOOOOOO 

//#def ine 

_MEMORY_AREA_6 

OxOFOOOOOO 

//#def ine 

_MEMORY_AREA_5 

OxOOFOOOOO 

//#def ine 

_MEMORY_AREA_4 

OxOOOFOOOO 

//#def ine 

_MEMORY_AREA_3 

OxOOOOFOOO 

//#def ine 

_MEMORY_AREA_2 

OxOOOOOFOO 
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//#def ine 
//#def ine 
//#def ine 
//#def ine 
//#def ine 
//#def ine 


MEM0RY_AREA_1 

MEMORY_AREA_0 

FIFO_UNDERFLOW 

FIFO_EMPTY 

FIFO_EXCEEDS_THRESHOLD 

FIFO_OVERFLOW 


OxOOOOOOFO 

OxOOOOOOOF 

ObOOOl 

ObOOlO 

ObOlOO 

OblOOO 


#define  _GLOBAL_INTERRUPT_MASK 
#define  _ENABLE_INTERRUPTS 
#define  _DISABLE_INTERRUPTS 


0x000040 

0x1 

0x0 


#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 


INTERRUPT_MASK 

DMA_ABORT_DETECTED_ENABLE 

TX_AREA_7_COMPLETE_ENABLE 

TX_AREA_6_COMPLETE_ENABLE 

TX_AREA_5_COMPLETE_ENABLE 

TX_AREA_4_COMPLETE_ENABLE 

TX_AREA_3_COMPLETE_ENABLE 

TX_AREA_2_COMPLETE_ENABLE 

TX_AREA_l_COMPLETE_ENABLE 

TX_AREA_0_COMPLETE_ENABLE 

RX_AREA_7_COMPLETE_ENABLE 

RX_ARE A_  6_C  OMP  L  E  T  E_ENAB  L  E 

RX_AREA_5_COMPLETE_ENABLE 

RX_AREA_4_COMPLETE_ENABLE 

RX_ARE A_3_C  OMP  L  E  T  E_ENAB  L  E 

RX_AREA_2_COMPLETE_ENABLE 

RX_ARE A_ 1_C OMP  L E  T E_ENAB L E 

RX_AREA_0_COMPLETE_ENABLE 

TX_DMA_COMPLETE_ENABLE 

RX_DMA_C  OMP  L  E  T  E_ENAB  L  E 

TX_INTERRUPTS_DISABLE 

RX_INTERRUPTS_DISABLE 

_TX_FIFO_INTERRUPT_ENABLE 

RX_FIFO_INTERRUPT_ENABLE 


0x000044 

0x100000 

0x080000 

0x040000 

0x020000 

0x010000 

0x008000 

0x004000 

0x002000 

0x001000 

0x000800 

0x000400 

0x000200 

0x000100 

0x000080 

0x000040 

0x000020 

0x000010 

0x000008 

0x000004 

OxFFFFFFFS 

OxFFFFFFFA 

0x000002 

0x000001 


#define  _ 
//#def ine 
//#def ine 
//#def ine 
//#def ine 
//#def ine 
//#def ine 
//#def ine 
//#def ine 
#def ine 
#def ine 
#def ine 
#def ine 


RECEIVE_FIFO_INTERRUPT_MASK 

_MEMORY_AREA_7 

_MEMORY_AREA_6 

_MEMORY_AREA_5 

_MEMORY_AREA_4 

_MEMORY_AREA_3 

_MEMORY_AREA_2 

_MEMORY_AREA_l 

_MEMORY_AREA_0 

_FIFO_UNDERFLOW_ENABLE 
_FIFO_EMPTY_ENABLE 
_FIFO_EXCEEDS_THRESHOLD_ENABLE 
_F I F 0_OVE RE L 0 W_ENAB L E 


0x000048 


ObOOOl 

ObOlOO 

OblOOO 


OxFOOOOOOO 

OxOFOOOOOO 

OxOOFOOOOO 

OxOOOFOOOO 

OxOOOOFOOO 

OxOOOOOFOO 

OxOOOOOOFO 

OxOOOOOOOF 

ObOOlO 


#define  _TRANSMIT_FIFO_INTERRUPT_MASK 

//#define  _MEMORY_AREA_7 

//# define  _MEMORY_AREA_6 

//# define  _MEMORY_AREA_5 

//#define  _MEMORY_AREA_4 

//# define  _MEMORY_AREA_3 

//# define  _MEMORY_AREA_2 


0x00004C 

OxFOOOOOOO 

OxOFOOOOOO 

OxOOFOOOOO 

OxOOOFOOOO 

OxOOOOFOOO 

OxOOOOOFOO 
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//# define  _MEM0RY_AREA_1 

//#define  _MEMORY_AREA_0 

//#define  _FIFO_UNDERFLOW_ENABLE 

//#define  _FIFO_EMPTY_ENABLE 

//#define  _FIFO_EXCEEDS_THRESHOLD_ENABLE 

//#define  _FIFO_OVERFLOW_ENABLE 


OxOOOOOOFO 

OxOOOOOOOF 

ObOOOl 

ObOOlO 

ObOlOO 

OblOOO 


#define  _DISCRETE_OUTPUT_CONTROL  0x000050 

#define  _8_BIT_0UTPUT_M0DE_SELECT  0x100 

#define  _DISCRETE_0UTPUT_7_SELECTED  0x080 

#define  _DISCRETE_0UTPUT_6_SELECTED  0x040 

#define  _DISCRETE_0UTPUT_5_SELECTED  0x020 

#define  _DISCRETE_0UTPUT_4_SELECTED  0x010 

#define  _DISCRETE_0UTPUT_3_SELECTED  0x008 

#define  _DISCRETE_0UTPUT_2_SELECTED  0x004 

#define  _DISCRETE_0UTPUT_1_SELECTED  0x002 

#define  _DISCRETE_OUTPUT_0_SELECTED  0x001 


#define  _AUTO_DMA_CONTROL 
//31:16  Number  of  64-bit  words  to  be 
#define  _TX_MEMORY_AREA_0_TO_0 
#define  _TX_MEMORY_AREA_0_TO_1 
#define  _TX_MEMORY_AREA_0_TO_2 
#define  _TX_MEMORY_AREA_0_TO_3 
#define  _TX_MEMORY_AREA_0_TO_4 
#define  _TX_MEMORY_AREA_0_TO_5 
#define  _TX_MEMORY_AREA_0_TO_6 
#define  _TX_MEMORY_AREA_0_TO_7 
#define  _RX_MEMORY_AREA_0_TO_0 

#define  _RX_MEMORY_AREA_0_TO_1 
#define  _RX_MEMORY_AREA_0_TO_2 
#define  _RX_MEMORY_AREA_0_TO_3 
#define  _RX_MEMORY_AREA_0_TO_4 
#define  _RX_MEMORY_AREA_0_TO_5 
#define  _RX_MEMORY_AREA_0_TO_6 
#define  _RX_MEMORY_AREA_0_TO_7 
#define  _AUTO_COUNTERS_RELOAD 

multiple  transfers  automatically 
#define  _TX_AUTO_DMA_ENABLE 
#define  _RX_AUTO_DMA_ENABLE 
#define  _TX_AUTO_DMA_DISABLE 
#define  _RX_AUTO_DMA_DISABLE 


0x000094 

transf ered 

0x0 

0x080 

0x100 

0x180 

0x200 

0x280 

0x300 

0x038 

0x0 

0x008 

0x010 

0x018 

0x020 

0x028 

0x030 

0x038 

0x004  //  Allows 

0x006 

0x005 

OxFFFFFFFD 

OxFFFFFFFE 


//  0x004 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 


00 : 0x0004F0 

_RX_MEMORY_AREA_ 

_RX_MEMORY_AREA_ 

_RX_MEMORY_AREA_ 

_RX_MEMORY_AREA_ 

_RX_MEMORY_AREA_ 

_RX_MEMORY_AREA_ 

_RX_MEMORY_AREA_ 

_RX_MEMORY_AREA_ 

_TX_MEMORY_AREA_ 

_TX_MEMORY_AREA_ 

_TX_MEMORY_AREA_ 

_TX_MEMORY_AREA_ 

_TX_MEMORY_AREA_ 


AUTO  DMA  BLOCK 

0_BLOCK_COUNT 

.l_BLOCK_COUNT 

2_BLOCK_COUNT 

3_BLOCK_COUNT 

4_BLOCK_COUNT 

5_BLOCK_COUNT 

.6_BLOCK_COUNT 

7_BLOCK_COUNT 

0_BLOCK_COUNT 

.l_BLOCK_COUNT 

2_BLOCK_COUNT 

3_BLOCK_COUNT 

4_BLOCK_COUNT 


COUNT 

0x000400 

0x000410 

0x000420 

0x000430 

0x000440 

0x000450 

0x000460 

0x000470 

0x000480 

0x000490 

0x0004A0 

0x0004B0 

0x0004C0 
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#define  _TX_MEM0RY_AREA_5_BL0CK_C0UNT  0x000400 
#define  _TX_MEMORY_AREA_6_BLOCK_COUNT  0x0004E0 
#define  _TX_MEMORY_AREA_7_BLOCK_COUNT  0x0004F0 

//  9:0  Block  Count:  Number  of  DMA  blocks  to  be  transfered  before  a  DMA 
Block  Complete  int 


//  0X000500 : 0X0005F0  AUTO  DMA  GROUP  COUNT 
#deflne  _RX_MEMORY_AREA_0_GROUP_COUNT 
#define  _RX_MEMORY_AREA_l_GROUP_COUNT 
#define  _RX_MEMORY_AREA_2_GROUP_COUNT 
#deflne  _RX_MEMORY_AREA_3_GROUP_COUNT 
#define  _RX_MEMORY_AREA_4_GROUP_COUNT 
#deflne  _RX_MEMORY_AREA_5_GROUP_COUNT 
#define  _RX_MEMORY_AREA_6_GROUP_COUNT 
#deflne  _RX_MEMORY_AREA_7_GROUP_COUNT 
#deflne  _TX_MEMORY_AREA_0_GROUP_COUNT 
#define  _TX_MEMORY_AREA_l_GROUP_COUNT 
#deflne  _TX_MEMORY_AREA_2_GROUP_COUNT 
#define  _TX_MEMORY_AREA_3_GROUP_COUNT 
#define  _TX_MEMORY_AREA_4_GROUP_COUNT 
#deflne  _TX_MEMORY_AREA_5_GROUP_COUNT 
#define  _TX_MEMORY_AREA_6_GROUP_COUNT 
#deflne  _TX_MEMORY_AREA_7_GROUP_COUNT 


0x000500 

0x000510 

0x000520 

0x000530 

0x000540 

0x000550 

0x000560 

0x000570 

0x000580 

0x000590 

0x0005A0 

0x0005B0 

0x0005C0 

0x0005D0 

0x0005E0 

0x0005F0 


//  4:0  Block  Count:  Number  of  DMA  groups  to  be  transfered  before  the 


initial 


// 


DMA  address  is  reloaded 


//  0X000800 : 0X0008F0  AUTO  DMA  ADDRESS 


#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
//  31:0 


_RX_MEMORY_AREA_0 
_RX_MEMORY_AREA_l 
_RX_MEMORY_AREA_2 
_RX_MEMORY_AREA_3 
_RX_MEMORY_AREA_4 
_RX_MEMORY_AREA_5 
_RX_MEMORY_AREA_6 
_RX_MEMORY_AREA_7 
_TX_MEMORY_AREA_0 
_TX_MEMORY_AREA_l 
_TX_MEMORY_AREA_2 
_TX_MEMORY_AREA_3 
_TX_MEMORY_AREA_4 
_TX_MEMORY_AREA_5 
_TX_MEMORY_AREA_6 
_TX_MEMORY_AREA_7 
Starting  address 


_ADDRESS  0x000800 

_ADDRESS  0x000810 

_ADDRESS  0x000820 

_ADDRESS  0x000830 

_ADDRESS  0x000840 

_ADDRESS  0x000850 

_ADDRESS  0x000860 

_ADDRESS  0x000870 

_ADDRESS  0x000880 

_ADDRESS  0x000890 

_ADDRESS  0x0008A0 

_ADDRESS  0x0008B0 

_ADDRESS  0x0008C0 

_ADDRESS  0x0008D0 

_ADDRESS  0x0008E0 

_ADDRESS  0x0008F0 

in  memory  to  begin  DMA  transfer 


#def ine 

// 

#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 


_RECEIVE_CONTROL 

RX_CHANNEL_ORGANIZATION 

_8_CHANNELS 

_2_POLYPHASE_CHANNELS 

_4_POLYPHASE_CHANNELS 

_8_POLYPHASE_CHANNELS 

_BIT_REGISTERS_ENABLE 

_FIFO_FLUSH 

_RX_HEADER_ENABLE 


0x001100 

0x0000 

0x4000 

0x8000 

OxCOOO 

0x2000 

0x1000 

0x0400 
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#def ine 
selected 

_RX_MASTER_ENABLE 

0x0200 

// 

Must  be 

#def ine 
not  set 

_POLYPHSE_SEQUENCIAL_DATA 

0x0100 

// 

Usually 

#def ine 

_l_RX_MEMORY_AREA 

0x0 

#def ine 

_2_RX_MEMORY_AREAS 

0x0010 

#def ine 

_3_RX_MEMORY_AREAS 

0x0020 

#def ine 

_4_RX_MEMORY_AREAS 

0x0030 

#def ine 

_5_RX_MEMORY_AREAS 

0x0040 

#def ine 

_6_RX_MEMORY_AREAS 

0x0050 

#def ine 

_7_RX_MEMORY_AREAS 

0x0060 

#def ine 

_8_RX_MEMORY_AREAS 

0x0070 

#def ine 

_RX_CIRCUITRY_ENABLE 

0x0002 

// 

Enables 

receiver  circuitry 

#define  _RX_ENABLE  0x0001  // 

Should  be  enabled  after  initialization 

#define  _RX_DISABLE  OxFFFFFFFE 


#define  MANUAL  DMA  RX  MEMORY  SELECT  0x001104 


#define  _MANUAL_RX_MEMORY_SELECT 

#define  _START_MANUAL_DMA_RX 

#define  _RX_DIRECT_FIFO_ACCESS 
#define  _RX_MEMORY_AREA_SELECT 

//  OxOOX  =  Memory  area  to  be  used  for 

#define  _RECEIVE_TIMING_CONTROL 

#define  _TIMING_CONTROL_DISABLE 

#define  _RECEIVE_CLOCK_RATE 

93MHz=92999998 


0x100 

0x010 

0x008 

0X007 

transfer  (0-7) 

0x001108 

0x0 

0x001128  //For 


//Registers  of  pages  67-73  are  not  used. 

#  de  f 1 ne  _RX_MEMORY_AREA_0_ORGAN I Z AT I ON 

#  de  f 1 ne  _RX_MEMORY_AREA_l_ORGAN I Z AT I ON 

#  de  f 1 ne  _RX_MEMORY_AREA_2_ORGAN I Z AT I ON 

#  de  f 1 ne  _RX_MEMORY_AREA_3_ORGAN I Z AT I ON 

#  de  f 1 ne  _RX_MEMORY_AREA_4_ORGAN I Z AT I ON 

#  de  f 1 ne  _RX_MEMORY_AREA_5_ORGAN I Z AT I ON 

#  de  f 1 ne  _RX_MEMORY_AREA_6_ORGAN I Z AT I ON 

#  de  f 1 ne  _RX_MEMORY_AREA_7_ORGAN I Z AT I ON 


0x001300 

0x001310 

0x001320 

0x001330 

0x001340 

0x001350 

0x001360 

0x001370 


//For  the  above  registers,  the  following  fields  are  used 


#define  _RX_END_CHANNEL_0  0x0 

#define  _RX_END_CHANNEL_1  0x1000 

#define  _RX_END_CHANNEL_2  0x2000 

#define  _RX_END_CHANNEL_3  0x3000 

#define  _RX_END_CHANNEL_4  0x4000 

#define  _RX_END_CHANNEL_5  0x5000 

#define  _RX_END_CHANNEL_6  0x6000 

#define  _RX_END_CHANNEL_7  0x7000 

#define  _RX_START_CHANNEL_0  0x0 

#define  _RX_START_CHANNEL_1  0x0100 

#define  _RX_START_CHANNEL_2  0x0200 

#define  _RX_START_CHANNEL_3  0x0300 

#define  _RX_START_CHANNEL_4  0x0400 

#define  _RX_START_CHANNEL_5  0x0500 
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#define  _RX_START_CHANNEL_6  0x0600 
#define  _RX_START_CHANNEL_7  0x0700 
#define  _RX_CHANNEL_0_DIRECTED  0x0001 
#define  _RX_CHANNEL_1_DIRECTED  0x0002 
#define  _RX_CHANNEL_2_DIRECTED  0x0004 
#define  _RX_CHANNEL_3_DIRECTED  0x0008 
#define  _RX_CHANNEL_4_DIRECTED  0x0010 
#define  _RX_CHANNEL_5_DIRECTED  0x0020 
#define  _RX_CHANNEL_6_DIRECTED  0x0040 
#define  _RX_CHANNEL_7_DIRECTED  0x0080 


#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 


RX_MEMORY_AREA_0_POINTER 
RX_MEMORY_AREA_l_POINTER 
RX_MEMORY_AREA_2_POINTER 
RX_MEMORY_AREA_3_POINTER 
RX_MEMORY_AREA_4_POINTER 
RX_MEMOR Y_ARE A_5_P  0 1 N T E R 
RX_MEMORY_AREA_6_POINTER 
RX_MEMORY_AREA_7_POINTER 


0x001400 

0x001410 

0x001420 

0x001430 

0x001440 

0x001450 

0x001460 

0x001470 


//For  the 
//  30:16 
// 

longwords ) 

//  0:14 
above ) 

#define  _RX_MEMORY_AREA_0_LIMITS 
#define  _RX_MEMORY_AREA_l_LIMITS 
#define  _RX_MEMORY_AREA_2_LIMITS 
#define  _RX_MEMORY_AREA_3_LIMITS 
#define  _RX_MEMORY_AREA_4_LIMITS 
#define  _RX_MEMORY_AREA_5_LIMITS 
#define  _RX_MEMORY_AREA_6_LIMITS 
#define  _RX_MEMORY_AREA_7_LIMITS 


relation 
(64-bit 

of  the  designated  memory  area  (as 


0x001500 

0x001510 

0x001520 

0x001530 

0x001540 

0x001550 

0x001560 

0x001570 


above  registers,  the  following  values  must  be  entered: 
Last  address  of  the  designated  memory  area  in 
to  the  starting  address  of  the  Rx  memory  block 

The  first  address 


//For  the  above  registers,  the  following  values  must  be  entered: 
//  30:16  Size  of  the  designated  memory  area  (64-bit  longwords) 
//  0:14  Threshold  at  which  interrupt  will  be  generated 


#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 


RX_MEMORY_AREA_0_PTR_STATUS 

RX_MEMORY_AREA_l_PTR_STATUS 

RX_MEMORY_AREA_2_PTR_STATUS 

RX_MEMORY_AREA_3_PTR_STATUS 

RX_MEMORY_AREA_4_PTR_STATUS 

RX_MEMORY_AREA_5_PTR_STATUS 

RX_MEMORY_AREA_6_PTR_STATUS 

RX_MEMORY_AREA_7_PTR_STATUS 


0x001800 

0x001810 

0x001820 

0x001830 

0x001840 

0x001850 

0x001860 

0x001870 


//For  the  above  registers,  the  following  values  must  be  entered: 

//  0:14  Next  address  to  be  read  from  the  designated  FIFO 

Memory  area 

//  PROVIDED  FOR  DEBUG  PURPOSES 

#define  _RECEIVE_FIFO _ STATUS  0x001900 

//#define  _MEMORY_AREA_7  OxFOOOOOOO 

//#define  _MEMORY_AREA_6  OxOFOOOOOO 
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//#def ine 
//#def ine 
//#def ine 
//#def ine 
//#def ine 
//#def ine 
//#def ine 
//#def ine 
//#def ine 
//#def ine 


MEM0RY_AREA_5 

MEM0RY_AREA_4 

MEM0RY_AREA_3 

MEM0RY_AREA_2 

MEM0RY_AREA_1 

MEMORY_AREA_0 

FIFO_UNDERFLOW 

FIFO_EMPTY 

FIFO_EXCEEDS_THRESHOLD 

FIFO_OVERFLOW 


OxOOFOOOOO 

OxOOOFOOOO 

OxOOOOFOOO 

OxOOOOOFOO 

OxOOOOOOFO 

OxOOOOOOOF 

ObOOOl 

ObOOlO 

ObOlOO 

OblOOO 


#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 


RX_MEMORY_AREA_0_WR_PTR_STATUS 

RX_MEMORY_AREA_l_WR_PTR_STATUS 

RX_MEMORY_AREA_2_WR_PTR_STATUS 

RX_MEMORY_AREA_3_WR_PTR_STATUS 

RX_MEMORY_AREA_4_WR_PTR_STATUS 

RX_MEMORY_AREA_5_WR_PTR_STATUS 

RX_MEMORY_AREA_6_WR_PTR_STATUS 

RX_MEMORY_AREA_7_WR_PTR_STATUS 


OxOOlAOO 

OxOOlAlO 

0x001A20 

0x001A30 

0x001A40 

OxOOlASO 

0x001A60 

0x001A70 


//For  the  above  registers,  the  following  values  must  be  entered: 
//  0:14  Next  address  of  the  RX  Memory  to  be  written. 

//  PROVIDED  FOR  DEBUG  PURPOSES 


#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 


RX_MEMORY_AREA_0_FIFO_COUNT 
RX_MEMOR Y_ARE A_ 1_F I F 0_C OUN T 
RX_MEMOR Y_ARE A_2_F I F 0_C OUN T 
RX_MEMOR Y_ARE A_3_F I F 0_C OUN T 
RX_MEMORY_AREA_4_FIFO_COUNT 
RX_MEMOR Y_ARE A_5_F I F 0_C OUN T 
RX_MEMOR Y_ARE A_  6_F I F 0_C OUN T 
RX_MEMORY_AREA_7_FIFO_COUNT 


OxOOlBOO 

OxOOlBlO 

0x001B20 

0x001B30 

0x001B40 

OxOOlBSO 

OxOOlBGO 

0x001B70 


//For  the  above  registers,  the  following  values  must  be  entered: 

//  0:14  Amount  of  data  remaining  in  the  designated  Memory 

Area  FIFO 


#def ine 

_TRANSMI T_CONTROL 

0x002100 

#def ine 

_TX_BIT_REGISTERS_ENABLE 

0x2000 

#def ine 

_TX_FIFO_FLUSH 

0x1000 

#define 

_TX_FIFO_ENABLE 

OxFFFFEFFF 

#define 

_TX_MASTER_SYNC_ENABLE 

0x0400  // 

Must 

be 

set??? 

#def ine 

_TX_MASTER_ENABLE 

0x0200  // 

Must 

be 

selected 

#def ine 

_l_TX_MEMORY_AREA 

0x0 

#def ine 

_2_TX_MEMORY_AREAS 

0x0010 

#def ine 

_3_TX_MEMORY_AREAS 

0x0020 

#def ine 

_4_TX_MEMORY_AREAS 

0x0030 

#def ine 

_5_TX_MEMORY_AREAS 

0x0040 

#def ine 

_6_TX_MEMORY_AREAS 

0x0050 

#def ine 

_7_TX_MEMORY_AREAS 

0x0060 

#def ine 

_8_TX_MEMORY_AREAS 

0x0070 

#def ine 

_TX_CIRCUITRY_ENABLE 

0x0002  // 

Enables 

transmitter  circuitry 

#define  _TX_ENABLE  0x0001  // 

Should  be  enabled  after  initialization 
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OxFFFFFFFE 


#define  _TX_DISABLE 


#define  _MANUAL_DMA_TX_MEMORY_SELECT  0x002104 


#define  _TX_ENDIAN_SELECT  0x100 
#define  _DIRECT_TX_MEMORY_ACCESS  0x008 
#define  _TX_MEMORY_AREA_SELECT  0x007 
//  OxOOX  =  Memory  area  to  be  used  for  transfer  (0-7) 

#define  _TX_TIMING_CONTROL  0x002108 
#define  _TX_TIMING_CONTROL_DISABLE  0x0 


#define  _TX_CLOCK_RATE 

93MHz=92999998 


0x002128 


#define  _PRN_CONTROL  0x00211C 

//18:4  PRN  Seed  value 

#define  _4_SAMPLES_PER_SYMBOL  0x8 

#define  _2_SAMPLES_PER_SYMBOL  0x4 

#define  _l_SAMPLE_PER_SYMBOL  0x0 

#define  _PRN_CODE_TX_ENABLE  0x1 


//If  0  FIFO  data  is  transmitted 


#define  _PRN_ZERO_IQ_VALUE  0x002120 

//31 :  16  Q 
//00:15  I 


#define  _PRN_ONE_IQ_VALUE 
//31:16  Q 

//00:15  I 


//Registers  of  pages  84-88  are  not  used. 


#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 


TX_MEMORY_AREA_0_ORGAN I Z AT I ON 
TX_MEMORY_AREA_l_ORGAN I Z AT I ON 
TX_MEMORY_AREA_2_ORGANI ZATION 
TX_MEMORY_AREA_3_ORGANI ZATION 
TX_MEMORY_AREA_4_ORGAN I Z AT I ON 
TX_MEMORY_AREA_5_ORGAN I Z AT I ON 
TX_MEMORY_AREA_6_ORGAN I Z AT I ON 
TX_MEMORY_AREA_7_ORGAN I Z AT I ON 


0x002124 


0x002300 

0x002310 

0x002320 

0x002330 

0x002340 

0x002350 

0x002360 

0x002370 


//For  the  above  registers,  the  following  fields  are  used 


#define  _TX_END_CHANNEL_0  0x0 

#define  _TX_END_CHANNEL_1  0x1000 

#define  _TX_END_CHANNEL_2  0x2000 

#define  _TX_END_CHANNEL_3  0x3000 

#define  _TX_END_CHANNEL_4  0x4000 

#define  _TX_END_CHANNEL_5  0x5000 

#define  _TX_END_CHANNEL_6  0x6000 

#define  _TX_END_CHANNEL_7  0x7000 

#define  _TX_START_CHANNEL_0  0x0 

#define  _TX_START_CHANNEL_1  0x0100 

#define  _TX_START_CHANNEL_2  0x0200 

#define  _TX_START_CHANNEL_3  0x0300 

#define  _TX_START_CHANNEL_4  0x0400 

#define  _TX_START_CHANNEL_5  0x0500 

#define  _TX_START_CHANNEL_6  0x0600 


//For 
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#define  _TX_START_CHANNEL_7  0x0700 

//The  values  below  can  be  ORed  to  allow  multiple  channels 
#define  _TX_CHANNEL_0_DIRECTED  0x0001 

#define  _TX_CHANNEL_1_DIRECTED  0x0002 

#define  _TX_CHANNEL_2_DIRECTED  0x0004 

#define  _TX_CHANNEL_3_DIRECTED  0x0008 

#define  _TX_CHANNEL_4_DIRECTED  0x0010 

#define  _TX_CHANNEL_5_DIRECTED  0x0020 

#define  _TX_CHANNEL_6_DIRECTED  0x0040 

#define  _TX_CHANNEL_7_DIRECTED  0x0080 


#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 


TX_MEMORY_AREA_0_POINTER 

TX_MEMORY_AREA_l_POINTER 

TX_MEMORY_AREA_2_POINTER 

TX_MEMORY_AREA_3_POINTER 

TX_MEMORY_AREA_4_POINTER 

TX_MEMORY_AREA_5_POINTER 

TX_MEMORY_AREA_6_POINTER 

TX_MEMORY_AREA_7_POINTER 


0x002400 

0x002410 

0x002420 

0x002430 

0x002440 

0x002450 

0x002460 

0x002470 


//For  the 
//  30:16 
// 

longwords ) 

//  0:14 
above ) 

#define  _TX_MEMORY_AREA_0_LIMITS 
#define  _TX_MEMORY_AREA_l_LIMITS 
#define  _TX_MEMORY_AREA_2_LIMITS 
#define  _TX_MEMORY_AREA_3_LIMITS 
#define  _TX_MEMORY_AREA_4_LIMITS 
#define  _TX_MEMORY_AREA_5_LIMITS 
#define  _TX_MEMORY_AREA_6_LIMITS 
#define  _TX_MEMORY_AREA_7_LIMITS 


relation 
(64-bit 

of  the  designated  memory  area  (as 


0x002500 

0x002510 

0x002520 

0x002530 

0x002540 

0x002550 

0x002560 

0x002570 


above  registers,  the  following  values  must  be  entered: 
Last  address  of  the  designated  memory  area  in 
to  the  starting  address  of  the  Rx  memory  block 

The  first  address 


//For  the  above  registers,  the  following  values  must  be  entered: 
//  30:16  Size  of  the  designated  memory  area  (64-bit  longwords) 
//  0:14  Threshold  at  which  interrupt  will  be  generated 


#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 


TX_MEMORY_AREA_0_PTR_STATUS 

TX_MEMORY_AREA_l_PTR_STATUS 

TX_MEMORY_AREA_2_PTR_STATUS 

TX_MEMORY_AREA_3_PTR_STATUS 

TX_MEMORY_AREA_4_PTR_STATUS 

TX_MEMORY_AREA_5_PTR_STATUS 

TX_MEMORY_AREA_6_PTR_STATUS 

TX_MEMORY_AREA_7_PTR_STATUS 


0x002800 

0x002810 

0x002820 

0x002830 

0x002840 

0x002850 

0x002860 

0x002870 


//For  the  above  registers,  the  following  values  must  be  entered: 

//  0:14  Next  address  to  be  read  from  the  designated  FIFO 

Memory  area 

//  PROVIDED  FOR  DEBUG  PURPOSES 

#define  _TRANSMIT_FIFO _ STATUS  0x002900 

//#define  _MEMORY_AREA_7  OxFOOOOOOO 

//#define  _MEMORY_AREA_6  OxOFOOOOOO 
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//#def ine 
//#def ine 
//#def ine 
//#def ine 
//#def ine 
//#def ine 
//#def ine 
//#def ine 
//#def ine 
//#def ine 


MEM0RY_AREA_5 

MEM0RY_AREA_4 

MEM0RY_AREA_3 

MEM0RY_AREA_2 

MEM0RY_AREA_1 

MEMORY_AREA_0 

FIFO_UNDERFLOW 

FIFO_EMPTY 

FIFO_EXCEEDS_THRESHOLD 

FIFO_OVERFLOW 


OxOOFOOOOO 

OxOOOFOOOO 

OxOOOOFOOO 

OxOOOOOFOO 

OxOOOOOOFO 

OxOOOOOOOF 

ObOOOl 

ObOOlO 

ObOlOO 

OblOOO 


#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 


TX_MEMORY_AREA_0_RD_PTR_STATUS 

TX_MEMORY_AREA_l_RD_PTR_STATUS 

TX_MEMORY_AREA_2_RD_PTR_STATUS 

TX_MEMORY_AREA_3_RD_PTR_STATUS 

TX_MEMORY_AREA_4_RD_PTR_STATUS 

TX_MEMORY_AREA_5_RD_PTR_STATUS 

TX_MEMORY_AREA_6_RD_PTR_STATUS 

TX_MEMORY_AREA_7_RD_PTR_STATUS 


0x002A00 

0x002A10 

0x002A20 

0x002A30 

0x002A40 

0x002A50 

0x002A60 

0x002A70 


//For  the  above  registers,  the  following  values  must  be  entered: 
//  0:14  Next  address  of  the  TX  Memory  to  be  READ. 

//  PROVIDED  FOR  DEBUG  PURPOSES 


#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 
#def ine 


TX_MEMORY_AREA_0_FIFO_COUNT 

TX_MEMORY_AREA_l_FIFO_COUNT 

TX_MEMORY_AREA_2_FIFO_COUNT 

TX_MEMORY_AREA_3_FIFO_COUNT 

TX_MEMORY_AREA_4_FIFO_COUNT 

TX_MEMORY_AREA_5_FIFO_COUNT 

TX_MEMORY_AREA_6_FIFO_COUNT 

TX_MEMORY_AREA_7_FIFO_COUNT 


0x002B00 

0x002B10 

0x002B20 

0x002B30 

0x002B40 

0x002B50 

0x002B60 

0x002B70 


//For  the  above  registers,  the  following  values  must  be  entered: 

//  0:14  Amount  of  data  remaining  in  the  designated  Memory 

Area  FIFO 


#define  _DITHER_NOISE_POWER_CONTROL  0x008000 

//7:0  Noise  power  from  -90dBm  (0x0)  to  -30  dBm  (OxFF) 

#define  _ATTENUATOR_POWER_CONTROL  0x008004 


//Registers  of  pages  95-100  are  not  used 


PMCRADIOl.H 

//Red  River  Engineering 

//Include  file  for  use  with  WaveRunner  Multi-Card  Library 
//  PN:  SRC-905-008-R00  (August  16,  2001) 

//  Author  -  Patrick  Jennings 

#ifndef  PMCRADIOI _ H 

#define  PMCRADIOI _ H 

#ifdef  _ cplusplus 
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extern  "C"  { 

#endif 

typedef  struct  { 

int  NumBuffers; 
unsigned  long  Buf SizeBytes ; 
unsigned  long  ErrStatus; 
unsigned  long  v_dmap[32]; 
unsigned  long  p_dmap[32]; 

}  s_DMAConf; 

typedef  struct  { 

int  DevNum;  //Device  Number  of  the  Radio 

}  s_PMCRadio; 


/* 

s_PMCRadio  RadioO; 

RadioO . DevNum  =  0; 

OpenPMCRadio (SRadioO)  ; 

ClosePMCRadio (&RadioO)  ; 

*/ 

/////////////////////////////////////////////////////////////////////// 

/////// 

//  PROTYPES 

/////////////////////////////////////////////////////////////////////// 

/////// 

/*===================================================================== 


Prototype  int  OpenWaveRunner (void) ; 

Function  OpenWaveRunner  instantiates  a  Wave  Walker  radio  as  a 

Windows  device  and 

memory  maps  its  physical  PCI  space  to  a  local  memory  image.  The  local 
memory  image  is 

used  to  access  the  radio  via  the  Wave  Walker  memory  map  described  in 
the  Wave  Walker  Hardware  Reference  Manual. 

OpenWaveRunner  must  be  called  before  any  of  the  Wave  Walker  library 
functions  can  be  used. 

CloseWaveRunner  must  be  called  prior  to  exiting  a  program  that  has 
called  OpenWaveRunner 
to  prevent  memory  leaks. 

Return  Values 

0  Successful  open  and  memory  mapping  of  Wave  Walker  Radio 
-1  Wave  Walker  device  not  accessible 
-2  OS  unable  to  memory  map  device 


===============* / 

int  OpenWaveRunner 0 ;  //Opens  a 

WaveRunner  and  maps  it 

int  OpenMultiWaveRunner ( int  iDeviceNum) ; 
int  OpenPMCRadio ( s_PMCRadio  *  PMCRadio) ; 

/*=============================================================: 


179 


Prototype  int  CloseWaveRunner (void) ; 

Function  Unmaps  and  deallocates  system  memory  assigned  to  a 

Wave  walker  device. 

This  function  must  be  called  prior  to  exiting  any  program  that  has 
issued  an 

OpenWaveRunner  command.  Wave  Walker  library  functions  can  no  longer  be 
used  after 

this  function  is  executed  unless  a  new  OpenWaveRunner  command  is 
issued . 

Return  Values 
0  Successful  operation 

-1  Unable  to  deallocate  memory  (system  fault) 


===============* / 

int  CloseWaveRunner 0 ;  //Closes  and 

deletes  a  WaveRunner 

int  CloseMultiWaveRunner (int  iDeviceNum) ; 
int  ClosePMCRadio (s_PMCRadio  *  PMCRadio) ; 

7*================================================================^ 


Prototype  int  GetMemPointer (unsigned  long  *Memptr) ; 

Function  GetMemPointer  returns  a  pointer  to  the  Wave  Walker 

local  memory  image.  This  pointer  can  be  used  to  access  any  location  in 
the  Wave  Walker  memory  map.  The  user  must  pass  the  pointer  by 
reference  by  calling  as  follows: 

unsigned  long  *MyWaveRunnerptr ;  //User  defined  pointer  to 

Wave  Walker 

GetMemPointer ( (unsigned  long  *)  SMyWaveRunnerptr) ;  //Call  to 

initialize  pointer 

Once  initialized  the  pointer  can  be  used  to  access  Wave  Walker  as 
follows : 

Write  to  the  transmitter  real  data  FIFO: 

#define  TX_REAL_OFFSET  0x1000 

* (MyWaveRunnerptr  +  TX_REAL_OFFSET/4 )  =  0x12345678; 

Read  from  Wave  Walker  status  register: 

#define  STATUS_REG_OFFSET  0x058C 

data  =  * (MyWaveRunnerptr  +  STATUS_REG_OFFSET/4 ) ; 

note:  Wave  Walker  memory  map  addresses  must  be  divided  by  4  when  using 
the  pointer 

returned  by  GetMemPointer.  The  division  by  4  translates  the  byte 
offset  memory  map 

listings  to  32-bit  (4  byte)  word  pointer  increments.  This  is  NOT 
required  for  the 

Write  and  Read  Wave  Walker  functions  found  elsewhere  in  this  library. 
Return  Values 
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0 

-1 


Successful  operation 
Unsuccessful  operation 


===============* / 

int  GetMemPointer (unsigned  long*  ptr) ;  //Provides  a  pointer  to 

the  virtual  map  of  the  radio 

int  GetMultiMemPointer (int  iDeviceNum,  unsigned  long*  ptr); 
int  GetPMCRadioMemPointer ( s_PMCRadio  *  ,  unsigned  long*  ptr); 

/*===================================================================== 


Prototype  int  WriteWaveRunner (unsigned  long  AddressOf f set,  unsigned 
long  Data) ; 

Function  The  WriteWaveRunner  function  writes  the  data  value 

passed  in 

variable  Data  to  the  Wave  Walker  device  memory  mapped  register 
indicated  by 

variable  AddressOf f set .  AddressOf f set  is  any  valid  Wave  Walker  memory 
map  address. 

Please  see  the  Wave  Walker  Hardware  Reference  Manual  for  a  listing  of 

valid  memory 

map  offset  addresses. 

Return  Values 

0  Successful  operation 

-1  Unsuccessful  operation 


===============* / 

int  WriteWaveRunner (unsigned  long  AddressOf f set ,  unsigned  long  Data); 
/ /Writes 

int  WriteMultiWaveRunner (int  iDeviceNum,  unsigned  long  AddressOf f set , 
unsigned  long  Data) ; 

int  WritePMCRadio ( s_PMCRadio  *  PMCRadio,  unsigned  long  AddressOf f set , 
unsigned  long  Data);  //Writes 


/* 


Prototype  int  ReadWaveRunner (unsigned  long  AddressOf f set,  unsigned 
long  *Data) ; 

Function  ReadWaveRunner  returns  the  value  located  at 

AddressOf f set  to  the  variable  Data  passed  by  reference.  AddressOf f set 
is  any  valid  Wave  Walker  memory  map  address. 


Calling  form: 

unsigned  long  address, 

variables 

ReadWaveRunner (address. 


data 


data; 
&data) ; 


//  User  defined 

//  Call  to  read 


Data  value  returned  by  reference. 
Return  Values 

0  Successful  operation 

181 


-1 


Unsuccessful  operation 


===============* / 

int  ReadWaveRunner (unsigned  long  AddressOf f set ,  unsigned  long  *Data) ; 
//Reads  by  ref 

int  ReadMultiWaveRunner ( int  iDeviceNum,  unsigned  long  AddressOf f set , 
unsigned  long  *Data) ; 

int  ReadPMCRadio ( s_PMCRadio  *  PMCRadio,  unsigned  long  AddressOf f set , 
unsigned  long  *Data) ;  //Reads  by  ref 


/* 


int  ReadWRConfigSpace (unsigned  long  nOffset,  char  *PCIconfig,  unsigned 
long  nBytes ) ; 

int  ReadMultiWRConf igSpace (int  iDeviceNum,  unsigned  long  nOffset,  char 
*PCIconfig,  unsigned  long  nBytes) 


===========*/ 

int  ReadWRConfigSpace (unsigned  long  nOffset,  char  *PCIconfig,  unsigned 
long  nBytes) ; 

int  ReadMultiWRConf igSpace ( int  iDeviceNum,  unsigned  long  nOffset,  char 
*PCIconfig,  unsigned  long  nBytes); 

int  ReadPMCRadioConf igSpace ( s_PMCRadio  *  PMCRadio, unsigned  long 
nOffset,  char  *PCIconfig,  unsigned  long  nBytes); 


/* 


int  WriteWRConf igSpace (unsigned  long  nOffset,  char  *PCIconfig,  unsigned 
long  nBytes) 

int  WriteMultiWRConf igSpace (int  iDeviceNum,  unsigned  long  nOffset,  char 
*PCIconfig,  unsigned  long  nBytes) 


===========*/ 

int  WriteWRConf igSpace (unsigned  long  nOffset,  char  *PCIconfig,  unsigned 
long  nBytes) ; 

int  WriteMultiWRConf igSpace (int  iDeviceNum,  unsigned  long  nOffset,  char 
*PCIconfig,  unsigned  long  nBytes); 

int  WritePMCRadioConf igSpace ( s_PMCRadio  *  PMCRadio,  unsigned  long 
nOffset,  char  *PCIconfig,  unsigned  long  nBytes); 

/*===================================================================== 


Prototype  int  GetFirmRev (unsigned  long  *date) ; 

Function  GetFirmRev  returns  the  contents  of  the  Wave  Walker 

firmware  revision 

register.  A  read  of  the  firmware  revision  register  can  be  used  to 
quickly  verify 
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the  communication  path  to  the  Wave  Walker  radio.  The  firmware  revision 
date  is  a 

hexadecimal  value  passed  by  reference. 

Calling  form: 

unsigned  long  date;  //  User  defined  variable  for 

the  revision  date 

GetFirmRev (&date) ;  //  Function  call  to  write  firmware 

revision  date 

The  variable  date  is  updated  with  the  contents  of  the  Wave  Walker 
firmware  revision 

register  (32  bit  Hex  constant,  for  example  0x09171999,  note  the  date 
only  makes  sense 

when  viewed  as  an  unsigned  long  hexadecimal  number)  A  date  of  all  O's 
indicates  an 
access  problem. 

Return  Values 

0  Successful  operation 

-1  Unsuccessful  operation 


===============* / 

int  GetFirmRev (unsigned  long  *  date);  //Shows  the 

Firmware  revison 

int  GetMultiFirmRev (int  iDeviceNum,  unsigned  long  *  date); 

int  GetPMCRadioFirmRev ( s_PMCRadio  *  PMCRadio,  unsigned  long  *  date); 


/* 


Prototype  int  Conf igWaveRunner (char  ConfigFname  [80]); 

Function  This  function  is  used  to  load  Wave  Walker 

configuration  files  created 

using  the  Waveformer  configuration  tool.  The  Waveformer  tool  creates 
two  sets  of  three 

configuration  files.  One  set  has  a  ".h"  extension,  the  other  has  a 
".txt"  extension. 

The  Conf igWaveRunner  function  indirectly  uses  the  ".h"  versions  of 
these  files. 

Indirectly  means  that  the  filename  passed  to  the  function  as 
ConfigFname  contains  a  list 

of  the  .h  files  to  be  uploaded.  For  example  consider  a  file  named 
"Conf igExample . txt " . 

The  file  is  a  text  file  with  three  entries  as  follows: 

bdinit . h 
txinit . h 
rxinit . h 

(note  the  User  may  modify  the  file  names) 
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The  calling  sequence  for  Conf IgWaveRunner  using  the  example  file  is: 

Conf IgWaveRunner ( "Conf IgExample . txt " ) ; 

The  function  opens  the  pointer  file  "ConfigExample.txt"  to  find  the 
three  configuration 

file  names  it  contains.  The  contents  of  the  three  .h  files  are 
automatically  uploaded 
to  the  Wave  Walker  radio. 

Note:  The  configuration  pointer  file  and  its  ".h"  files  must  all  be 

collocated  in  a 

working  directory  or  path  recognized  by  the  User  application  program. 
Return  Values 

0  Successful  operation 

-1  Unable  to  find  configuration  pointer  file 

-2  Unable  to  find  one  or  more  of  the  ".h"  files 

-3  System  unable  to  communicate  with  Radio 


===============* / 

int  Conf IgWaveRunner  (char  ConfigFname  [80]);  //Configs  a  WaveRunner 
from  the  Excel  tool 

int  Conf igMultiWaveRunner  (int  iDeviceNum,  char  ConfigFname  [80]); 
int  Conf igPMCRadio  (s_PMCRadio  *  PMCRadio,  char  ConfigFname  [80]); 
//Configs  a  WaveRunner  from  the  Excel  tool 

/*===================================================================== 

===============* / 

//  void  WaveRunnerlsr (unsigned  long  status) 

//  WaveRunnerlsr  is  the  entry  point  for  any  interrupt  generated  by  a 
WaveRunner 

//  device.  This  function  must  always  be  included  in  any  program  that 
uses  the 

//  Wave  Walker  windows  library.  Uncomment  and  move  this  function  into 
your  main  code  space 

//  and  replace  the  printf  statement  with  your  own  ISR  code  if  you  are 
using  interrupts. 

/*===================================================================== 

===============* / 

int  GetDMAPA (unsigned  long  *wrdmapa,  unsigned  long  *wrdmava) ; 

int  GetMultiDMAPA (int  iDeviceNum,  unsigned  long  *wrdmapa,  unsigned  long 

*wrdmava) ; 

int  GetPMCRadioDMAPA ( s_PMCRadio  *  PMCRadio,  unsigned  long  *wrdmapa, 
unsigned  long  *wrdmava) ; 

/*===================================================================== 

===============* / 

//  unsigned  long  ReturnMaxDMABuf f erSize ( ) 

// 

//  Returns  the  size  in  bytes  allocated  for  each  M301  to  do  DMA 
transfers 

/*===================================================================== 

===============*/ 
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unsigned  long  GetMaxDMABuf f erSize ( ) ; 

unsigned  long  GetMultiMaxDMABuf ferSize (int  iDeviceNum) ; 
unsigned  long  GetPMCRadioMaxDMABuf f erSize ( s_PMCRadio  *  PMCRadio) ; 

void  SetupDMABuf f ers ( int  iDevNum,  s_DMAConf  *  DMAConfig) ; 
void  SetupPMCRadioDMABuf f ers ( s_PMCRadio  *  PMCRadio,  s_DMAConf  * 
DMAConfig) ; 

void  CloseDMABuf f ers ( int  iDevNum,  s_DMAConf  *  DMAConfig); 
void  ClosePMCRadioBuf f ers ( s_PMCRadio  *  PMCRadio,  s_DMAConf  * 
DMAConfig) ; 

void  SetDMABuff erSize ( int  Pages); 

void  SetMultiDMABuff erSize ( int  iDeviceNum,  int  Pages); 

void  SetPMCRadioDMABuff erSize ( s_PMCRadio  *  PMCRadio, int  Pages); 

int  CountSOls (void) ; 
int  CountPMCRadios (void)  ; 

void  PMCRadioIsr (unsigned  long  status); 
void  PMCRadioIsrO (unsigned  long  status); 
void  PMCRadioIsrl (unsigned  long  status); 
void  PMCRadioIsr2 (unsigned  long  status); 
void  PMCRadioIsrS (unsigned  long  status); 
void  PMCRadioIsrl (unsigned  long  status); 
void  PMCRadioIsrS (unsigned  long  status); 
void  PMCRadioIsrG (unsigned  long  status); 
void  PMCRadioIsr? (unsigned  long  status); 

#ifndef  NOISR 
/* 

Move  the  following  lines  to  your  program  if  you  are  going 
to  use  interrupts.  Replace  the  printf  statement  with  your  ISR  code. 
*/ 

#ifndef  USERISR 

void  WaveRunnerlsr (unsigned  long  status) 

{ 

PMCRadioIsrO (status) ; 

} 

#endif 

#ifndef  USERISRO 

void  PMCRadioIsrO (unsigned  long  status) 

{ 

} 

#endif 

#ifndef  USERISRl 

void  PMCRadioIsrl (unsigned  long  status) 

{ 

} 

#endif 

#ifndef  USERISR2 

void  PMCRadioIsr2 (unsigned  long  status) 

{ 
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} 

#endif 

#ifndef  USERISR3 

void  PMCRadioIsrS (unsigned  long  status) 

{ 

} 

#endif 

#ifndef  USERISR4 

void  PMCRadioIsri (unsigned  long  status) 

{ 

} 

#endif 

#ifndef  USERISR5 

void  PMCRadioIsrS (unsigned  long  status) 

{ 

} 

#endif 

#ifndef  USERISR6 

void  PMCRadioIsrG (unsigned  long  status) 

{ 

} 

#endif 

#ifndef  USERISR7 

void  PMCRadioIsr? (unsigned  long  status) 

{ 

} 

#endif 

#endif 

char  *  QueryRRProductID (void)  ; 
char  *  QueryLibBuildDateString (void)  ; 
unsigned  long  QueryDriverXLibVersion (void) ; 
unsigned  long  QueryLibBuildDate (void) ; 

/* 

start  sync  and  end  sync  are  used  to  coordinate  global  variable  use 
outside  the  ISR  routine,  a  start  sync  and  end  sync  should  frame 
any  statement (s)  that  use(s)  a  global  variable  common  to  your  ISR. 
*/ 

void  startsync (void) ; 

void  startmultisync ( int  iDeviceNum) ; 

void  endsync (void) ; 

void  endmultisync ( int  iDeviceNum); 

#ifdef  _ cplusplus 

} 


#endif 

#endif 
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